|
|
|
|
|
|
|
|
|
|
- Propriétés spécifiques à la description des variables de type URI
- Fonctions manipulant les variables de type URI
URI (Type de variable) En anglais : URI
Le type URI (Uniform Resource Identifier) permet d'identifier une ressource physique (par exemple un fichier) ou abstraite (par exemple une page Web). Il existe deux types d'URI : - Les URL (Uniform Resource Locator) : identifient une ressource à travers son moyen d'accès et son emplacement.
Exemples : - Adresse web : https://www.pcsoft.fr/windevmobile/index.html
- Emplacement d'un fichier sur disque : file:///C:/Users/johndoe/Documents/log.txt
- Les URN (Uniform Resource Name) : identifient une ressource par son nom. Elles ne permettent pas de localiser la ressource mais doivent rester uniques et persister même si la ressource cesse d'exister ou devient indisponible.
Exemple : Numéro ISBN d'un livre : urn:isbn:0-395-36341-1
Une URI peut être représentée sous la forme d'une chaîne de caractères dont la syntaxe respecte la norme définie par la RFC 3986. Chaque URI peut contenir jusqu'à cinq parties : <schéma> : [//<autorité>]<chemin>[? <requête>] [ # <fragment> ] - Le schéma (ou URI Scheme) est une lettre suivie de n'importe quelle combinaison de lettres, de chiffres, du signe plus (+), du point (.) ou d'un tiret (-) et se termine par deux points (:). Dans le cas d'une URL, il correspond généralement au protocole à utiliser pour accéder à la ressource : http, https, ftp, etc.
- La partie autorité de l'URI est une partie optionnelle qui correspond aux informations d'identification pour l'accès à la ressource. Elle est en général de la forme :
[<utilisateur>[:<mot de passe>]]hôte[:<port>] - Le chemin est une suite de segments séparés par des slash (/). Dans le cas d'une URL sur une page Web par exemple, il représente le chemin d'accès la ressource sur l'hôte.
- La requête est une partie optionnelle précédée d'un '?' et suivie d'un ensemble de couples 'clé=valeur' séparés par '&'. Dans le cas d'une URL sur une page Web par exemple, elle permet de passer des paramètres nommés à la page.
- Le fragment est une partie optionnelle précédée d'un '#' qui permet de fournir des informations supplémentaires permettant d'accéder à une ressource secondaire (numéro de page, ancre d'une page HTML, etc.).
Remarque : Pour plus de détails sur la déclaration de ce type de variable et l'utilisation des propriétés WLangage, consultez Déclaration d'une variable. Remarques Propriétés spécifiques à la description des variables de type URI Les propriétés suivantes peuvent être utilisées pour manipuler une variable de type URI : | | | | Nom de la propriété | Type manipulé | Effet |
|---|
| Autorité | Chaîne de caractères | - Partie "autorité" de l'URI,
- Chaîne vide si non spécifiée.
Cette propriété est disponible en lecture/écriture. | | Chemin | Chaîne de caractères | Chemin de l'URI. Cette propriété est disponible en lecture/écriture. | | Fragment | Chaîne de caractères | - Fragment de l'URI,
- Chaîne vide si non spécifié.
Cette propriété est disponible en lecture/écriture. | | Hôte | Chaîne de caractères | - Hôte de l'URI,
- Chaîne vide si non spécifié.
Cette propriété est disponible en lecture/écriture.Attention : Si la propriété Hôte est modifiée : - les propriétés Utilisateur et MotDePasse sont réinitialisées : ces deux propriétés doivent alors être renseignées.
- la propriété Port est réinitialisée : la propriété Port doit également être renseignée.
| | MotDePasseUtilisateur | Chaîne de caractères | - Mot de passe de l'utilisateur,
- Chaîne vide si non spécifié.
Cette propriété est disponible en lecture/écriture. | | Port | Entier | - Numéro de port (compris entre 1 et 65365),
- 0 si non spécifié.
Cette propriété est disponible en lecture/écriture. | | Requête | Chaîne de caractères | - Requête présente dans l'URI,
- Chaîne vide si non spécifiée.
Cette propriété est disponible en lecture/écriture. | | Schéma | Chaîne de caractères | Schéma présent dans l'URI. En cas de modification, cette propriété est obligatoire et ne peut pas être vide. Cette propriété est disponible en lecture/écriture. | | Utilisateur | Chaîne de caractères | Nom d'utilisateur. Cette propriété est disponible en lecture/écriture. | | Valeur | Chaîne de caractères | URI complète. |
Pour réinitialiser le contenu d'une variable de type URI, il est possible d'utiliser la fonction VariableRAZ. Fonctions manipulant les variables de type URI Les fonctions suivantes manipulent des variables de type URI :
| | | BufferVersURI | Sauvegarde le contenu d'un buffer dans une ressource identifiée par son URI. | | FichierVersURI | Sauvegarde le contenu d'un fichier dans une ressource identifiée par son URI. | | URIRécupèreInfo | Récupère des informations sur une ressource de type URI. | | URISélecteur | Ouvre une fenêtre du système pour sélectionner une ressource provenant : - du système de fichiers de l'appareil,
- du Cloud (Google Drive, Microsoft OneDrive, etc.)
- ou d'un des gestionnaires de contenu installés sur l'appareil.
| | URIVersBuffer | Charge en arrière-plan le contenu d'une ressource (image, texte, etc.) identifiée par son URI dans une variable de type buffer. | | URIVersFichier | Enregistre en arrière-plan le contenu d'une ressource (image, texte, etc.) identifiée par son URI dans un fichier externe. |
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|