Ajoute ou modifie un cookie dans une requête HTTP.
Deux types d'utilisation sont disponibles :
- Si la requête est exécutée par la fonction HTTPRequête, la fonction HTTPCookieEcrit doit être appelée avant la fonction HTTPRequête afin de fixer la valeur des cookies à transmettre au serveur HTTP.
Si la requête est exécutée avec la fonction HTTPEnvoie, la fonction HTTPCookieEcrit doit être exécutée directement sur la variable de type httpRequête (syntaxe 2).
Remarque : Les cookies lus et envoyés par la fonction
HTTPRequête sont uniquement conservés en mémoire dans l'application. Ils n'ont pas de rapport avec les cookies des navigateurs Web installés sur le poste.
// Fixe la valeur d'un cookie d'identification avec une valeur mémorisée
HTTPCookieEcrit("domaine.com", "ID", ChargeParamètre("ID"))
// Effectue une requête HTTP
HTTPRequête("www.MonSite.com?Login")
// Récupère et sauve la valeur du cookie renvoyée par le serveur
sID est une chaîne = HTTPCookieLit(".monsite.fr", "ID")
SauveParamètre("ID", sID)
Syntaxe
Requête exécutée par la fonction HTTPRequête Masquer les détails
HTTPCookieEcrit(<Domaine> , <Nom> , <Valeur>)
<Domaine> : Chaîne de caractères
Domaine de validité du cookie.Le cookie sera envoyé dans toutes les requêtes HTTP dont le domaine se termine par le domaine de validité du cookie.
Par exemple, un cookie dont le domaine de validité est ".mondomaine.fr" sera envoyé lors des requêtes suivantes :
- http://mondomaine.fr
- http://www.mondomaine.fr/index.html
- http://serveur.mondomaine.fr/page.awp
Il ne sera pas envoyé dans les requêtes suivantes :- http://www.mondomaine.com
- http://autredomaine.fr
<Nom> : Chaîne de caractères
Nom du cookie.Ce nom n'est pas sensible à la casse.
<Valeur> : Chaîne de caractères
Valeur du cookie.Remarques :
- La valeur d'un cookie est limité à 4Ko. Au delà de cette taille, le serveur est libre de rejeter le cookie.
- Les caractères de contrôles (TAB, RC, etc.) ainsi que le point-virgule et les zéros binaires ne sont pas autorisés.
Remarques
- Si la gestion des cookies n'a pas été activée avec la fonction HTTPCookieGère, les cookies ne sont pas envoyés au serveur :
- Si le cookie n'existe pas, il est créé.
Composante : wd280com.dll