pages, élément (Schéma des paramètres ASP.NET)

Article
08/10/2011

Définit globalement des paramètres de configuration spécifiques aux pages, tels que les directives ASP.NET, pour les pages et les contrôles compris dans la portée du fichier de configuration.

<pages     
   asyncTimeout="number"
   autoEventWireup="[True|False]"
   buffer="[True|False]"
   clientIDMode="[AutoID|Predictable|Static]"
   compilationMode="[Always|Auto|Never]" 
   controlRenderingCompatibilityVersion="[3.5|4.0]"
   enableEventValidation="[True|False]"
   enableSessionState="[True|False|ReadOnly]"
   enableViewState="[True|False]"
   enableViewStateMac="[True|False]"
   maintainScrollPositionOnPostBack="[True|False]" 
   masterPageFile="file path" 
   maxPageStateFieldLength="number" 
   pageBaseType="typename, assembly"
   pageParserFilterType="string" 
   smartNavigation="[True|False]"
   styleSheetTheme="string"
   theme="string"
   userControlBaseType="typename"
   validateRequest="[True|False]"
   viewStateEncryptionMode="[Always|Auto|Never]" 
>
   <controls>...</controls>
   <namespaces>...</namespaces>
   <tagMapping>...</tagMapping>
   <ignoreDeviceFilters>...</ignoreDeviceFilters>
</pages>

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut	Description
asyncTimeout	Attribut TimeSpan facultatif. Spécifie le nombre de secondes d'attente avant la fin de l'exécution d'un gestionnaire asynchrone pendant le traitement asynchrone. Cet attribut est une nouveauté de .NET Framework version 2.0. La valeur par défaut est "0:00:45" (45 secondes).
autoEventWireup	Attribut Boolean facultatif. Spécifie si les événements de page sont automatiquement activés. C'est le cas lorsque la connexion à des événements automatiques se produit. Cela signifie que le système joint automatiquement les méthodes d'une signature particulière (Page_Load par exemple). Pour plus d'informations, consultez Modèle d'événements du contrôle serveur Web ASP.NET. La valeur par défaut est True.
buffer	Attribut Boolean facultatif. Spécifie si la ressource URL utilise la mise en mémoire tampon des réponses. La valeur par défaut est True.
clientIDMode	Spécifie l'algorithme à utiliser pour générer des valeurs ClientID pour les contrôles. La valeur par défaut est Predictable. La valeur par défaut du contrôle est Inherit. Par conséquent, l'algorithme par défaut pour les contrôles dans une page est déterminé par le paramètre ClientIDMode de la page. Une valeur par défaut différente peut être définie dans la directive @ Page de la page ou dans la directive @ Control d'un contrôle utilisateur. Pour plus d'informations sur les algorithmes, consultez ClientIDMode et Identification du contrôle serveur Web ASP.NET.
compilationMode	Attribut CompilationMode facultatif. Spécifie si une page ou un contrôle ASP.NET doit être compilé au moment de l'exécution. L'attribut compilationMode est une nouveauté du .NET Framework 2.0. Cet attribut peut avoir l'une des valeurs suivantes : La valeur par défaut est Always. ValeurDescription Always La page doit toujours être compilée. Auto ASP.NET ne compilera pas la page, si possible. Never La page ou le contrôle ne doit jamais être compilé de façon dynamique. Si une page contient un bloc de script ou une construction de code qui doit être compilé, ASP.NET retournera une erreur et la page ne s'exécutera pas.
controlRenderingCompatibilityVersion	Spécifie si les contrôles doivent restituer du code HTML comme ils le faisaient dans une version antérieure d'ASP.NET ou comme ils sont conçus pour le faire dans la version actuelle. Remarque controlRenderingCompatibilityVersion est une nouveauté d'ASP.NET 4.Lui affecter le numéro de la version actuelle revient à ne pas le définir.Dans les deux cas, les contrôles restituent le code HTML tel qu'il est conçu pour la version actuelle.La version la plus récente pour cet attribut est 3.5. Pour plus d'informations, consultez les propriétés PagesSection.ControlRenderingCompatibilityVersion et Control.RenderingCompatibility.
enableEventValidation	Spécifie si les pages et les contrôles valident des événements de publication et de rappel. La valeur par défaut est True.
enableSessionState	Attribut String facultatif. Spécifie des configurations requises d'état de session pour les ressources qui sont dans la portée du fichier de configuration. L'attribut enableSessionState peut avoir l'une des valeurs suivantes : La valeur par défaut est True. ValeurDescription False Indique que l'état de session est désactivé. ReadOnly Indique que l'état de session n'est pas accessible en écriture. True Indique que l'état de session est activé.
enableViewState	Attribut Boolean facultatif. Spécifie si l'état d'affichage est activé et conservé d'une demande de page à une autre. La valeur par défaut est True.
enableViewStateMac	Attribut Boolean facultatif. Spécifie si ASP.NET doit exécuter un code d'authentification de message (MAC) sur l'état d'affichage de la page lors de la publication de la page par le client. Si la valeur True est affectée à cet attribut, l'état d'affichage chiffré est contrôlé pour vérifier qu'il n'a pas été falsifié sur le client. La valeur par défaut est True.
maintainScrollPositionOnPostBack	Attribut Boolean facultatif. Spécifie s'il faut retourner l'utilisateur au même emplacement dans le navigateur client lorsque les pages sont publiées sur le serveur. Si la valeur est False, l'utilisateur est retourné en haut de la page lors d'une publication. Cet attribut est une nouveauté du .NET Framework 2.0. La valeur par défaut est False.
masterPageFile	Attribut String facultatif. Spécifie le chemin d'accès à la page maître par rapport au fichier de configuration local. Les pages dont l'attribut masterPageFile a la valeur True doivent contenir un contrôle Content comme contrôle de niveau supérieur. Cet attribut est une nouveauté du .NET Framework 2.0. La valeur par défaut est une chaîne vide ("").
maxPageStateFieldLength	Attribut Int32 facultatif. Spécifie la longueur maximale, en caractères, du champ d'état de la page. Si un nombre positif est défini, le champ d'état d'affichage envoyé au navigateur client est segmenté et chaque segment est inférieur à la taille spécifiée dans l'attribut maxPageStateFieldLength. Si la valeur définie est un nombre négatif, le champ d'état d'affichage ne doit pas être segmenté. Cet attribut est une nouveauté du .NET Framework 2.0. La valeur par défaut est "-1".
pageBaseType	Attribut String facultatif. Spécifie le type de base à utiliser uniquement lorsque les pages sont autonomes. Il est substitué par l'attribut inherits dans un fichier autonome. La valeur par défaut est "System.Web.UI.Page".
pageParserFilterType	Attribut String facultatif. Spécifie le nom de type d'un filtre utilisé par l'analyseur ASP.NET pour déterminer si un élément est autorisé dans la page au moment de l'analyse. Le filtre doit être dérivé de la classe PageParserFilter. Cet attribut est une nouveauté du .NET Framework 2.0. La valeur par défaut est une chaîne vide ("").
smartNavigation	Attribut Boolean facultatif. Spécifie si la navigation intelligente est activée. La navigation intelligente exige Microsoft Internet Explorer version 5.5 ou une version ultérieure. Lorsque la navigation intelligente est activée, l'utilisateur bénéficie des avantages suivants : Le clignotement de navigation est éliminé. La position de défilement est persistante d'une page à l'autre. Le focus de l'élément est persistant d'une page à l'autre. Le dernier état de la page est le seul état conservé par l'historique sur le navigateur. Cet attribut est une nouveauté du .NET Framework version 2.0, mais il a été déconseillé en faveur de l'attribut maintainScrollPositionOnPostBack. La valeur par défaut est False.
styleSheetTheme	Attribut String facultatif. Spécifie le nom du dossier « thème nommé » à utiliser pour appliquer le thème avant des déclarations de contrôle, contrairement à l'attribut theme qui définit le thème à appliquer après la déclaration de contrôle. Cet attribut est une nouveauté du .NET Framework 2.0. La valeur par défaut est une chaîne vide ("").
theme	Attribut String facultatif. Spécifie le nom du thème utilisé pour les pages dans la portée du fichier de configuration. Le thème spécifié doit exister sous forme soit d'application soit de thème global. Si ce thème n'existe pas, une exception HttpException est levée. Cet attribut est une nouveauté du .NET Framework 2.0. La valeur par défaut est une chaîne vide ("").
userControlBaseType	Attribut String facultatif. Spécifie le type de base à utiliser uniquement lorsque les pages sont autonomes. La valeur par défaut est "System.Web.UI.UserControl".
validateRequest	Attribut Boolean facultatif. Indique qu'ASP.NET examine toutes les entrées du navigateur à la recherche d'éventuelles données dangereuses. Si la valeur est True, la validation de la demande est effectuée par comparaison de toutes les données d'entrée par rapport à une liste de valeurs potentiellement dangereuses. Si une correspondance est trouvée, ASP.NET lève une exception HttpRequestValidationException. La valeur par défaut est True.
viewStateEncryptionMode	Attribut ViewStateEncryptionMode facultatif. Spécifie le mode de chiffrement de l'état d'affichage. La propriété ViewStateEncryptionMode se substitue à cet attribut défini dans le fichier de configuration. Cet attribut peut avoir l'une des valeurs suivantes : ValeurDescription Always L'état d'affichage est toujours chiffré. Auto L'état d'affichage est chiffré, si un contrôle le demande. Never L'état d'affichage n'est jamais chiffré, même si un contrôle le demande. Cet attribut est une nouveauté du .NET Framework 2.0. La valeur par défaut est Auto.

Éléments enfants

Élément	Description
controls	Définit une collection de directives de Registre et les espaces de noms où les préfixes de balise résident.
namespaces	Définit une collection de directives Import à utiliser pendant la précompilation d'un assembly.
tagMapping	Définit une collection de types de balise qui sont remappés au moment de la compilation sur d'autres types de balise.
ignoreDeviceFilters	Définit une collection d'éléments de périphérique que le navigateur doit ignorer lorsque la page est restituée. Pour plus d'informations, consultez IgnoreDeviceFilters.

Éléments parents

Élément	Description
configuration	Élément racine obligatoire dans chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.
system.web	Spécifie l'élément racine des paramètres de configuration ASP.NET dans un fichier de configuration et contient des éléments de configuration qui configurent des applications Web ASP.NET et contrôlent le comportement des applications.

Notes

L'élément pages définit des paramètres de configuration propres à la page. Cette section de configuration prend en charge la définition globale de certaines directives de page et de contrôle ASP.NET pour toutes les pages et tous les contrôles dans la portée du fichier de configuration. Cela inclut les directives de niveau page suivantes, qui spécifient des paramètres utilisés par les compilateurs de pages et de contrôles utilisateur lorsque les compilateurs traitent les fichiers de page Web Forms ASP.NET (.aspx) et les fichiers de contrôle utilisateur (.ascx) :

la directive @ Page (@ Page) ;
la directive @ Import (@ Import) via l'élément enfant namespaces ;
la directive @ Register (@ Register) via l'élément enfant controls ;

L'élément pages fournit également la prise en charge du mappage de types de balises à d'autres types de balises au moment de l'exécution via l'élément tagMapping.

Remarque
L'ajout d'une directive @ Page à une page maître ne permet pas d'utiliser la même déclaration de directive dans les pages qui dépendent de la page maître.À la place, utilisez l'élément de configuration pages pour définir globalement des directives de page.

Configuration par défaut

L'élément pages par défaut n'est pas configuré explicitement dans le fichier Machine.config ou dans le fichier Web.config racine. Toutefois, il s'agit de la configuration par défaut retournée par une application. Les espaces de noms et contrôles sont ajoutés dans le fichier Web.config racine.

<pages 
   buffer="true" 
   clientIDMode="AutoID" 
   enableSessionState="true" 
   enableViewState="true" 
   enableViewStateMac="true" 
   smartNavigation="false" 
   autoEventWireup="true" 
   pageBaseType="System.Web.UI.Page" 
   userControlBaseType="System.Web.UI.UserControl" 
   validateRequest="true" 
   masterPageFile="" 
   theme="" 
   styleSheetTheme="" 
   maxPageStateFieldLength="-1" 
   compilationMode="Always" 
   pageParserFilterType="" 
   viewStateEncryptionMode="Auto" 
   maintainScrollPositionOnPostBack="false" 
   asyncTimeout="45"
>
   <namespaces>
      <clear />
   </namespaces>
   <tagMapping>
      <clear />
   </tagMapping>
</pages>

Exemple

L'exemple de code suivant montre comment spécifier plusieurs paramètres de configuration de page.

<configuration>
   <system.web>
      <pages buffer="true"
         enableSessionState="true"
         autoEventWireup="true"
         maintainScrollPositionOnPostBack="true"
         masterPageFile = "~/Masters/Page1.master" />
  </system.web>
</configuration>

Informations sur les éléments

Gestionnaire de section de configuration	PagesSection
Membre de configuration	Pages Page
Emplacements configurables	Machine.config Web.config racine Web.config au niveau de l'application Web.config de niveau répertoire virtuel ou physique
Spécifications	Microsoft Internet Information Services (IIS) version 5.0 ou ultérieure .NET Framework version 1.0 ou ultérieure Microsoft Visual Studio 2003 ou versions ultérieures

Voir aussi

Partager via

pages, élément (Schéma des paramètres ASP.NET)

Attributs et éléments

Attributs

Éléments enfants

Éléments parents

Notes

Configuration par défaut

Exemple

Informations sur les éléments

Voir aussi

Tâches

Référence

Concepts

Autres ressources

Ressources supplémentaires