|
|
|
|
|
|
|
|
|
|
- Si le mode de gestion des contextes par cookies est utilisé (constante ctxCookie utilisée dans la fonction ConfigureContexteAWP) :
- Si le mode de gestion des contextes sur disque est utilisé (constante ctxDisque utilisée dans la fonction ConfigureContexteAWP):
- Divers
DéclareContexteAWP (Fonction) En anglais : DeclareAWPContext Permet de déclarer une liste de variables dont la valeur sera persistante entre les affichages successifs des pages AWP. Cette fonction indique quelles variables sauver et restaurer à chaque ré-affichage de pages AWP. Il est ainsi possible de gérer un contexte AWP. Deux modes de gestion des contextes sont disponibles : - Gestion des contextes par cookies (par défaut).
- Gestion des contextes sur disque.
Le choix du mode de gestion des contextes est réalisé avec la fonction ConfigureContexteAWP. Par défaut, si cette fonction n'est pas utilisée, le mode de gestion des contextes est la gestion des contextes par cookies. La fonction DéclareContexteAWP est prise en compte uniquement en mode AWP. Il est conseillé d'utiliser cette fonction dans l'événement "Initialisation" associé au projet (pour les variables du projet) et / ou dans l'événement "Initialisation" des pages (pour les variables des pages). En règle générale, il faut utiliser cette fonction dans le traitement où sont déclarées et initialisées les variables.
Si votre projet utilise les sessions prélancées, cette fonction ne doit pas être utilisée dans l'événement "Initialisation" du projet. Cette fonction doit être utilisée dans l'événement "Initialisation lors d'une connexion à une session prélancée". Remarque : Pour plus de détails : Attention : Cette fonction est destinée aux développeurs maîtrisant WEBDEV.
gnNumProduitEnCours est un entier = 1
DéclareContexteAWP(gnNumProduitEnCours)
Syntaxe
<Résultat> = DéclareContexteAWP(<Nom de la variable 1> [, <Nom de la variable 2> [... [, <Nom de la variable N>]]])
<Résultat> : Booléen - Vrai si la ou les variables indiquées ont bien été restaurées,
- Faux dans le cas contraire (lors du premier affichage de la page par exemple).
<Nom de la variable 1> : Type de la variable Nom de la première variable à sauver à la fin de l'affichage. La valeur de cette variable sera récupérée lors des réaffichages successifs de la page. <Nom de la variable 2> : Type de la variable (paramètre optionnel) Nom de la 2ème variable à sauver à la fin de l'affichage. La valeur de cette variable sera récupérée lors des réaffichages successifs de la page. <Nom de la variable N> : Type de la variable (paramètre optionnel) Nom de la Nème variable à sauver à la fin de l'affichage. La valeur de cette variable sera récupérée lors des réaffichages successifs de la page. Remarques Si le mode de gestion des contextes par cookies est utilisé (constante ctxCookie utilisée dans la fonction ConfigureContexteAWP) : - La fonction DéclareContexteAWP utilise les cookies HTTP. Si le navigateur utilisé sur le poste en cours ignore les cookies HTTP, les valeurs des variables ne sont pas restaurées.
- La taille totale des valeurs des différentes variables est limitée à environ 4ko. Si la taille de ces valeurs est trop importante, ces valeurs seront tronquées (variables manquante et/ou contenu tronqué).
- La fonction DéclareContexteAWP n'est pas recommandée pour les données sensibles (mot de passe de l'utilisateur par exemple). En effet, les données transitent par le navigateur. Il ne faut donc PAS utiliser cette fonction pour mémoriser la connexion d'un utilisateur par exemple.
- Si deux variables sauvées ont le même nom (par exemple une dans le projet et l'autre dans une page) seule la première variable est mémorisée.
- La fonction DéclareContexteAWP renvoie Faux si une des variables n'a pas été restaurée.
- Seules les variables passées à la fonction DéclareContexteAWP lors d'un affichage de page pourront être récupérées lors de l'affichage suivant. Les variables passées précédemment ne sont pas automatiquement sauvegardées une nouvelle fois.
- Seules les variables de type simple (entier, chaîne, etc.) sont gérées.
Remarque: Pour manipuler des buffers, préférez l'utilisation du contexte sur disque.
Si le mode de gestion des contextes sur disque est utilisé (constante ctxDisque utilisée dans la fonction ConfigureContexteAWP): - La fonction DéclareContexteAWP utilise les contextes sur disque. Les valeurs des variables sont toujours restaurées.
- La taille totale des valeurs des différentes variables n'est pas limitée.
- La fonction DéclareContexteAWP peut être utilisée pour des données sensibles (mot de passe de l'utilisateur par exemple).
- Si deux variables sauvées ont le même nom (par exemple une dans le projet et l'autre dans une page), les deux variables sont mémorisées indépendamment.
- La fonction DéclareContexteAWP renvoie Faux si une des variables n'a pas été restaurée.
- Toutes les variables passées à la fonction DéclareContexteAWP lors d'un affichage de page pourront être récupérées lors de l'affichage suivant. Les variables passées précédemment sont automatiquement sauvegardées une nouvelle fois.
- Les variables de type simple (entier, chaîne, ...) sont gérées, ainsi que les variables de type :
- structure,
- classe,
- tableau,
- tableau associatif,
- combinaison
- énumération
- Les types de variables suivants ne sont pas gérés :
- les tableaux fixes,
- les membres globaux de classes,
- les tableaux associatifs de structures locales,
- les prises de référence vers des objets dynamiques.
Divers La fonction DéclareContexteAWP peut être appelée plusieurs fois pour cumuler les déclarations de variables persistantes. Composante : wd300page.dll |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|