Classe PagesSection

Article
03/25/2024

Représente la section <pages> d’un fichier Web.config.

Syntaxe

class PagesSection : ConfigurationSectionWithCollection

Méthodes

Le tableau suivant répertorie les méthodes exposées par la classe PagesSection.

Nom	Description
Ajouter	(Hérité de ConfigurationSectionWithCollection.)
Clear	(Hérité de `ConfigurationSectionWithCollection`.)
Get	(Hérité de `ConfigurationSectionWithCollection`.)
GetAllowDefinition	(Hérité de ConfigurationSection.)
GetAllowLocation	(Hérité de `ConfigurationSection`.)
Remove	(Hérité de `ConfigurationSectionWithCollection`.)
RevertToParent	(Hérité de `ConfigurationSection`.)
SetAllowDefinition	(Hérité de `ConfigurationSection`.)
SetAllowLocation	(Hérité de `ConfigurationSection`.)

Propriétés

Le tableau suivant répertorie les propriétés exposées par la classe PagesSection.

Nom	Description
`AsyncTimeout`	Valeur de `datetime` en lecture/écriture qui spécifie la durée que la page attendra pour effectuer des tâches asynchrones. La valeur par défaut est de 45 secondes.
`AutoEventWireup`	Une valeur `boolean` en lecture/écriture. `true` si les événements des pages ASP.NET sont automatiquement connectés aux fonctions de gestion des événements ; sinon, `false`. Par défaut, il s’agit de `true`. Remarque : lorsque cette propriété est `true`, ASP.NET ne nécessite pas d’événements pour spécifier des gestionnaires d’événements tels que `Page_Load` ou `Page_Init`. Cela signifie que le mot clé `Handles` dans Visual Basic n’est pas obligatoire dans le script serveur dans la page Web Forms. Par défaut, lorsque l’application web ASP.NET est créée dans Visual Studio, la valeur de la propriété `AutoEventWireup` est définie sur `false` dans la page .aspx ou le contrôle .ascx et les gestionnaires d’événements ne sont pas créés automatiquement. Ne définissez pas `AutoEventWireup` sur `true` si les performances sont une considération clé.
`Buffer`	Une valeur `boolean` en lecture/écriture. `true` si les pages .aspx et les contrôles .ascx utilisent la mise en mémoire tampon de réponse ; sinon, `false`. Par défaut, il s’agit de `true`. Remarque : lorsque la mise en mémoire tampon de réponse est activée, la sortie de la page ou du contrôle est mise en mémoire tampon jusqu’à ce que l’intégralité de la page ou du contrôle soit traitée. Ne définissez pas cette propriété sur `true` si les performances sont une considération clé.
`CompilationMode`	Énumération `sint32` en lecture/écriture qui définit si les pages .aspx et les contrôles .ascx sont compilés au temps d'exécution. Les valeurs possibles sont répertoriées plus loin dans la section Remarques.
`Controls`	Une valeur TagPrefixInfo contient des informations de configuration pour les contrôles personnalisés et utilisateur.
`EnableEventValidation`	Une valeur`boolean`. `true` si la validation de l’événement doit être effectuée ; sinon, `false`. Par défaut, il s’agit de `true`. Le mécanisme de validation des événements élimine le risque de demandes de publication non autorisées et de rappels d’un contrôle. Pendant le rendu, un contrôle enregistre ses événements, puis valide uniquement les événements spécifiques qui peuvent être déclenchés sur le contrôle pendant une requête de publication ou un rappel. Tous les contrôles pilotés par les événements dans ASP.NET utilisent désormais cette fonctionnalité par défaut. Toutefois, vous pouvez revenir au comportement de .NET Framework version 1.0 en désactivant éventuellement la validation des événements pour une application web. Remarque : le contrôle de base vérifie cette propriété pour déterminer si elle doit valider les événements. Un contrôle dérivé n’hérite pas de ce paramètre de contrôle de base. Par défaut, il est exempt de validation d’événement. Vous pouvez toujours demander à ASP.NET d’effectuer la validation d’événement sur le contrôle dérivé en ajoutant la propriété `EnableEventValidation` au contrôle dérivé lui-même et en la définissant sur `true`.
`EnableSessionState`	Valeur en lecture/écriture `sint32` qui spécifie si l’état de session est activé. Les valeurs possibles sont répertoriées plus loin dans la section Remarques.
`EnableViewState`	Une valeur `boolean` en lecture/écriture. `true` si l’état d’affichage est activé ; sinon, la valeur par défaut de `false.` est `true`.
`EnableViewStateMac`	Une valeur `boolean` en lecture/écriture. `true` si ASP.NET doit exécuter une vérification d’authentification de message dans l'état d'affichage de la page lorsque la page est publiée à partir du client ; sinon `false`. Par défaut, il s’agit de `true`. Remarque : pour des raisons de sécurité, cette propriété doit toujours être définie sur vrai.
`Location`	(Hérité de `ConfigurationSection`.) Propriété de clé.
`MaintainScrollPositionOnPostBack`	Une valeur `boolean` en lecture/écriture. `true` si la position de défilement de page du navigateur doit être conservée après la publication ; sinon, `false`. Par défaut, il s’agit de `false`.
`MasterPageFile`	Valeur en lecture/écriture `string` qui spécifie la référence à la page maître de l’application. La chaîne peut contenir un chemin relatif ou absolu.
`MaxPageStateFieldLength`	Valeur de `sint32` en lecture/écriture qui spécifie le nombre maximal de caractères qui peuvent être contenus dans un champ d’état d’affichage unique. La valeur par défaut est -1 (aucune limite spécifiée). Si la longueur des données stockées dépasse la valeur spécifiée, les données sont fractionnées entre plusieurs champs d’état d’affichage.
`Namespaces`	Valeur NamespaceInfo qui contient des références d’espace de noms importées automatiquement dans toutes les pages d’une application web. Cela rend les classes des espaces de noms spécifiés disponibles pour l’utilisation sur la page.
`PageBaseType`	Valeur en lecture/écriture `string` qui spécifie une classe code-behind que les pages .aspx héritent par défaut. La valeur par défaut est « System.Web.UI.Page ».
`PageParserFilterType`	Valeur en lecture/écriture `string` qui spécifie le type de filtre analyseur. Un filtre analyseur est une instance de la classe System.Web.UI.PageParserFilter. Au moment de l’exécution, le processus de compilation de page appelle le filtre d’analyseur pour case activée pour les modifications apportées au code source avant l’analyse de la page.
`Path`	(Hérité de `ConfigurationSection`.) Propriété de clé.
`SectionInformation`	(Hérité de `ConfigurationSection`.)
`SmartNavigation`	Une valeur `boolean` en lecture/écriture. `true` si la navigation intelligente est activée ; sinon, `false`. Par défaut, il s’agit de `false`. Remarque : la navigation intelligente nécessite Microsoft Internet Explorer 5.5, 6 ou 7.
`StyleSheetTheme`	Valeur en lecture/écriture `string` qui spécifie le nom d’un thème de feuille de style ASP.NET.
`TagMapping`	Valeur TagMapInfo qui contient les instructions de re-mappage de balise de configuration. Cette propriété permet le remappage des types de balises au moment de la compilation. Le re-mappage entraîne l’utilisation du type mappé à la place du type d’étiquette d’origine pour toutes les pages et contrôles de l’application ASP.NET dans l’étendue du fichier de configuration.
`Theme`	Valeur en lecture/écriture `string` qui spécifie le nom d’un thème de page ASP.NET.
`UserControlBaseType`	Valeur en lecture/écriture `string` qui spécifie une classe code-behind que les contrôles utilisateur héritent par défaut. La valeur par défaut est « System.Web.UI.UserControl ».
`ValidateRequest`	Une valeur `boolean` en lecture/écriture. `true` si ASP.NET effectue la validation de la requête sur toutes les entrées du navigateur ; sinon, `false`. Par défaut, il s’agit de `true`. La validation de la requête est effectuée en comparant les données d’entrée à une liste de valeurs potentiellement dangereuses. Si une correspondance se produit, ASP.NET déclenche une System.Web.HttpRequestValidationException.
`ViewStateEncryptionMode`	Énumération `sint32` en lecture/écriture qui spécifie le mode de chiffrement utilisé par ASP.NET pour les valeurs d’état d’affichage. Les valeurs possibles sont répertoriées plus loin dans la section Remarques.

Sous-classes

Cette classe ne contient aucune sous-classe.

Notes

Le tableau suivant répertorie les valeurs possibles pour la propriété CompilationMode. La valeur par défaut est 2 (Always).

Valeur	Mot clé	Description
0	`Auto`	ASP.NET ne compile pas la page, si possible.
1	`Never`	La page ou le contrôle n’est jamais compilé dynamiquement. Ce paramètre augmente les performances en disqualifiant la page spécifiée du processus de compilation. Si une page contient un bloc de script ou une construction de code nécessitant une compilation, ASP.NET retourne une erreur et la page ne s’exécute pas.
2	`Always`	La page doit toujours être compilée.

Le tableau suivant répertorie les valeurs possibles pour la propriété EnableSessionState. La valeur par défaut est 2 (True).

Valeur	Mot clé	Description
0	`False`	L’état de session est désactivé.
1	`ReadOnly`	L’état de la session est en lecture seule.
2	`True`	L’état de session est activé.

Le tableau suivant répertorie les valeurs possibles pour la propriété ViewStateEncryptionMode. La valeur par défaut est 0 (Auto).

Valeur	Mot clé	Description
0	`Auto`	Les informations d’état d’affichage sont chiffrées si un contrôle demande un chiffrement en appelant la méthode System.Web.UI.Page.RegisterRequiresViewStateEncryption.
1	`Always`	Les informations d’état d’affichage sont toujours chiffrées.
2	`Never`	Les informations d’état d’affichage ne sont jamais chiffrées, même si un contrôle le demande.

Hiérarchie d'héritage

ConfigurationSection

ConfigurationSectionWithCollection

PagesSection

Spécifications

Type	Description
Client	- IIS 7.0 sur Windows Vista - IIS 7.5 sur Windows 7 - IIS 8.0 sous Windows 8 - IIS 10.0 sur Windows 10
Serveur	- IIS 7.0 sur Windows Server 2008 - IIS 7.5 sous Windows Server 2008 R2 - IIS 8.0 sur Windows Server 2012 - IIS 8.5 sur Windows Server 2012 R2 - IIS 10.0 sur Windows Server 2016
Produit	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
Fichier MOF	WebAdministration.mof

Voir aussi

Microsoft.Web.Management.Client.Win32.ModulePage.Microsoft.Web.Management.Client.IModulePage.Initialize
System.Web.UI.Page.RegisterRequiresViewStateEncryption
System.Web.Configuration.PagesSection System.Web.HttpRequestValidationException
Classe AspSession
Classe ConfigurationSectionWithCollection
Classe NamespaceInfo
Classe SessionPageStateSection
Classe SessionStateSection
Classe TagMapElement
Classe TagMapInfo
Classe TagPrefixElement
Classe TagPrefixInfo
Énumération CompilationMode

Partager via