Partager via

Configuration de l’étape 2 : Configurer les paramètres de ASP.NET

  • Article

par Keith Newman et Robert McMurray

2.1. Paramètres d'état de session

Dans Planification d'un site Web ASP.NET sur IIS, vous avez décidé d'utiliser l'une des options de stockage de l'état de session suivantes :

  • in-process : l’état de session est stocké dans le processus de travail où s’exécute l’application ASP.NET.
  • Serveur d’état : l’état de session est stocké en dehors du processus de travail où s’exécute l’application ASP.NET.
  • SQL Server : l’état de session est stocké dans une base de données SQL Server.

Vous avez peut-être aussi choisi de stocker les données de session sur l'ordinateur client dans un cookie. Vous pouvez même combiner l'utilisation de cookies avec l'une des autres méthodes de stockage. Par exemple, vous pouvez stocker des données d'authentification dans un cookie tout en stockant d'autres données d'état de session dans une base de données SQL Server.

Les sections suivantes décrivent comment configurer l'état de session en fonction des décisions de planification que vous avez prises :

Stocker l'état de session dans un processus

Cette section décrit comment configurer l'état de session in-process à l'aide de l'interface utilisateur ou de la ligne de commande du Gestionnaire des services Internet (IIS).

Pour activer l'état de session in-process à l'aide de l'interface utilisateur

  1. Ouvrez le gestionnaire IIS et accédez au niveau que vous souhaitez gérer.

  2. Dans Affichage des fonctionnalités, double-cliquez sur État de session.

  3. Dans la page État de session, dans la zone Paramètres de mode d'état de session, cliquez sur In-process.

  4. (Facultatif) Configurez les paramètres de cookies dans la zone Paramètres de cookies dans la page État de session.

    Pour plus d'informations sur les paramètres de cookies, voir Mode de cookie pour l'état de session.

  5. Dans le champ Délai d'attente, entrez une valeur de délai d'attente au format hh:mm:ss. Par exemple, entrez 00:15:00 pour 15 minutes.

  6. (Facultatif) Cochez la case Utiliser l'identité d'hébergement pour l'emprunt d'identité pour utiliser l'authentification Windows et l'identité du processus hôte (ASP.NET ou une identité de service Windows) pour les connexions à distance.

  7. Cliquez sur Appliquer dans le volet Actions.

Pour activer l'état de session in-process à l'aide de la ligne de commande

Pour activer l'état de session in-process, utilisez la syntaxe suivante :

appcmd set config /commit:WEBROOT /section:sessionState /mode:InProc

La variable mode:InProc active l’état de session in-process. Par défaut, l'état de session in-process est activé.

Remarque

Quand vous utilisez Appcmd.exe pour configurer l'élément <sessionState> au niveau global dans IIS 8, spécifiez /commit:WEBROOT dans la commande pour que les modifications soient apportées au fichier Web.config racine au lieu de ApplicationHost.config.

Pour spécifier la durée par défaut pendant laquelle un objet de session est maintenu après la dernière demande associée à l’objet, utilisez la syntaxe suivante :

appcmd set config /section:asp /timeout:timeSpan

La variable timeSpan représente la durée maximale (hh:mm:ss) pendant laquelle un objet de session est maintenu après la dernière demande associée à cet objet. La valeur par défaut est 00:20:00.

Stocker l'État de session à l'aide du Serveur d'état

Cette section décrit comment configurer un serveur d'état pour le stockage de l'état de session à l'aide de l'interface utilisateur ou de la ligne de commande du Gestionnaire des services Internet (IIS).

Dans Planification d’un site Web ASP.NET sur IIS, vous avez pris les décisions de conception suivantes :

  • Définissez une chaîne de connexion pour le serveur d'état.
  • Spécifiez le nombre de secondes avant le délai d'expiration de connexion.
  • Déterminez s’il faut activer la compression.
  • Décidez si vous souhaitez stocker les données d'état de session dans un cookie.

Pour configurer un serveur d'état pour conserver l'état de session à l'aide de l'interface utilisateur

  1. Ouvrez le gestionnaire IIS et accédez au niveau que vous souhaitez gérer.
  2. Dans Affichage des fonctionnalités, double-cliquez sur État de session.
  3. Dans la page État de session, dans la zone Paramètres de mode d'état de session, cliquez sur Serveur d'état.
  4. Tapez une chaîne de connexion dans la zone de texte Chaîne de connexion ou cliquez sur Créer pour créer une chaîne de connexion.
  5. Tapez une valeur de délai d'attente dans la zone de texte Délai d'attente (en secondes). La valeur de délai d'attente par défaut est de 10 secondes.
  6. (Facultatif) Configurez les paramètres de cookies dans la zone Paramètres de cookies dans la page État de session. Pour plus d'informations sur les paramètres de cookies, voir Mode de cookie pour l'état de session.
  7. (Facultatif) Cochez la case Utiliser l'identité d'hébergement pour l'emprunt d'identité pour utiliser l'authentification Windows et l'identité du processus hôte (ASP.NET ou une identité de service Windows) pour les connexions à la base de données.
  8. Cliquez sur Appliquer dans le volet Actions.

Pour configurer un serveur d'état pour conserver l'état de session à l'aide de la ligne de commande

Pour configurer un serveur d'état pour conserver l'état de session, utilisez la syntaxe suivante :

appcmd set config /commit:WEBROOT /section:sessionState /mode:StateServer /stateConnectionString:string /stateNetworkTimeout:timeSpan /useHostingIdentity:true|false

La variable mode:StateServer définit le mode d'état de session pour stocker des données de session dans un serveur d'état. Par défaut, la variable string définit la chaîne de connexion utilisée par le serveur d'état. La valeur par défaut est tcpip=loopback:42424. La variable timeSpan définit la durée, en secondes, pendant laquelle la connexion au serveur d'état est conservée. La valeur par défaut est 10 secondes. La variable useHostingIdentity:true|false active ou désactive l'utilisation de l'authentification Windows et de l'identité du processus hôte (ASP.NET ou une identité de service Windows) pour les connexions à la base de données. La valeur par défaut est true.

Remarque

Quand vous utilisez Appcmd.exe pour configurer l'élément <sessionState> au niveau global dans IIS 8, spécifiez /commit:WEBROOT dans la commande pour que les modifications soient apportées au fichier Web.config racine au lieu de ApplicationHost.config.

Stocker l'État de session à l'aide de SQL Server

Cette section décrit comment configurer une base de données SQL Server pour le stockage de l'état de session à l'aide de l'interface utilisateur ou de la ligne de commande du Gestionnaire des services Internet (IIS).

Dans Planification d’un site Web ASP.NET sur IIS, vous avez pris les décisions de conception suivantes :

  • Définissez une chaîne de connexion pour la base de données.
  • Spécifiez le nombre de secondes avant le délai d'expiration de connexion.
  • Spécifiez le nombre de secondes qui doivent s'écouler avant d'essayer de se reconnecter.
  • Décidez si vous souhaitez activer une base de données personnalisée.
  • Déterminez s’il faut activer la compression.
  • Décidez si vous souhaitez stocker les données d'état de session dans un cookie.

Pour configurer un serveur SQL pour conserver l'état de session à l'aide de l'interface utilisateur

  1. Ouvrez le gestionnaire IIS et accédez au niveau que vous souhaitez gérer.
  2. Dans Affichage des fonctionnalités, double-cliquez sur État de session.
  3. Dans la page État de session, dans la zone Paramètres de mode d'état de session, cliquez sur Serveur SQL.
  4. Tapez une chaîne de connexion dans la zone de texte Chaîne de connexion ou cliquez sur Créer pour créer une chaîne de connexion. Si SQL server est installé sur le serveur que vous gérez, sélectionnez LocalSqlServer dans la zone de texte Chaîne de connexion.
  5. Tapez une valeur de délai d'attente dans la zone de texte Délai d'attente.
  6. (Facultatif) Cochez la case Activer la base de données personnalisé pour utiliser une base de données personnalisée pour stocker les données d'état de session.
  7. (Facultatif) Configurez les paramètres de cookies dans la zone Paramètres de cookies dans la page État de session. Pour plus d'informations sur les paramètres de cookies, voir Mode de cookie pour l'état de session.
  8. (Facultatif) Cochez la case Utiliser l'identité d'hébergement pour l'emprunt d'identité pour utiliser l'authentification Windows et l'identité du processus hôte (ASP.NET ou une identité de service Windows) pour les connexions distantes à la base de données SQL.
  9. Cliquez sur Appliquer dans le volet Actions.

Pour configurer un serveur SQL pour conserver l'état de session à l'aide de la ligne de commande

Pour configurer un serveur d'état pour conserver l'état de session, utilisez la syntaxe suivante :

appcmd set config /commit:WEBROOT /section:sessionState /mode:SqlServer /sqlConnectionString:string /sqlCommandTimeout:timeSpan /useHostingIdentity:true|false

La variable mode:SqlServer définit le mode d'état de session pour stocker des données de session dans une base de données de serveur SQL. Par défaut, la variable string définit la chaîne de connexion utilisée par le serveur SQL. Le paramètre par défaut est LocalSqlServer. La variable timeSpan définit la durée, en secondes, pendant laquelle la connexion au serveur SQL est conservée. La valeur par défaut est 30 secondes. La variable useHostingIdentity:true|false active ou désactive l'utilisation de l'authentification Windows et de l'identité du processus hôte (ASP.NET ou une identité de service Windows) pour les connexions à la base de données. La valeur par défaut est true.

Remarque

Quand vous utilisez Appcmd.exe pour configurer l'élément <sessionState> au niveau global dans IIS 8, spécifiez /commit:WEBROOT dans la commande pour que les modifications soient apportées au fichier Web.config racine au lieu de ApplicationHost.config.

Cette section décrit comment configurer une base de données SQL Server pour le stockage de l'état de session à l'aide de l'interface utilisateur ou de la ligne de commande du Gestionnaire des services Internet (IIS).

Dans Planification d’un site Web ASP.NET sur IIS, vous avez pris les décisions de conception suivantes :

  • Sélectionnez un mode de cookie : détection automatique, utiliser les cookies, utiliser le profil de périphérique ou utiliser un URI.
  • Spécifiez le nom du cookie (sauf si vous avez sélectionné l'utilisation d'un URI).
  • Spécifiez le nombre de minutes avant que le cookie expire (sauf si vous avez sélectionné l'utilisation d'un URI).
  • Sauf si vous avez sélectionné utiliser des cookies, décidez s’il faut régénérer un ID de session expiré.

Pour configurer le mode d'utilisation des cookies pour l'état de session à l'aide de l'interface utilisateur

  1. Ouvrez le gestionnaire IIS et accédez au niveau que vous souhaitez gérer.
  2. Dans Affichage des fonctionnalités, double-cliquez sur État de session.
  3. Dans la page État de session des Paramètres de cookies, sélectionnez Utiliser les cookies dans la liste déroulante Mode.
  4. Tapez un nom de cookie dans la zone de texte Nom ou utilisez le nom de cookie par défaut, ASP.NET_SessionId.
  5. Tapez une valeur de délai d'attente dans la zone de texte Délai d'attente ou utilisez 20 minutes, la valeur de délai d'attente par défaut.
  6. Cliquez sur Appliquer dans le volet Actions.

Pour configurer le mode d'utilisation des cookies pour l'état de session à l'aide de la ligne de commande

Pour configurer le mode d'utilisation des cookies pour l'état de session, utilisez la syntaxe suivante :

appcmd set config /commit:WEBROOT /section:sessionState /cookieless:UseCookies /cookieName:string /timeout:timeSpan

La variable cookieless:UseCookies configure IIS 8 pour utiliser le mode cookies pour l’état de session. Il s’agit de la valeur par défaut. La variable string correspond au nom du cookie. La valeur par défaut est ASP.NET_SessionId. La variable timeSpan définit la durée, en minutes, après laquelle le cookie expire. La valeur par défaut est 20 minutes. Par exemple, pour définir un cookie de mode cookie pour l'état de session (nommé MyCookie et qui expire après 40 minutes), tapez la commande suivante à l'invite de commandes et appuyez sur Entrée :

appcmd set config /commit:WEBROOT /section:sessionState /cookieless:UseCookies /cookieName:MyCookie /timeout:40

Remarque

Quand vous utilisez Appcmd.exe pour configurer l'élément <sessionState> au niveau global dans IIS 8, spécifiez /commit:WEBROOT dans la commande pour que les modifications soient apportées au fichier Web.config racine au lieu de ApplicationHost.config.

Pour configurer le mode de cookie de profil de périphérique pour l'état de session, utilisez la syntaxe suivante :

appcmd set config /commit:WEBROOT /section:sessionState /cookieless:UseDeviceProfile /cookieName:string /timeout:timeSpan /regenerateExpiredSessionId:true|false

La variable cookieless:UseDeviceProfile configure IIS 8 pour utiliser le mode cookie de profil d’appareil pour l’état de session. La variable string correspond au nom du cookie. La valeur par défaut est ASP.NET_SessionId. La variable timeSpan définit la durée, en minutes, après laquelle le cookie expire. La valeur par défaut est 20 minutes. La variable regenerateExpiredSessionId:true|false active ou désactive la régénération des ID de session ayant expiré.

Remarque

Quand vous utilisez Appcmd.exe pour configurer l'élément <sessionState> au niveau global dans IIS 8, spécifiez /commit:WEBROOT dans la commande pour que les modifications soient apportées au fichier Web.config racine au lieu de ApplicationHost.config.

Pour configurer le mode de détection automatique des cookies pour l'état de session, utilisez la syntaxe suivante :

appcmd set config /commit:WEBROOT /section:sessionState /cookieless:AutoDetect /cookieName:string /timeout:timeSpan /regenerateExpiredSessionId:true|false

La variable cookieless:AutoDetect configure IIS 8 pour utiliser le mode de détection automatique des cookies pour l’état de session. La variable string correspond au nom du cookie. La valeur par défaut est ASP.NET_SessionId. La variable timeSpan définit la durée, en minutes, après laquelle le cookie expire. La valeur par défaut est 20 minutes. La variable regenerateExpiredSessionId:true|false active ou désactive la régénération des ID de session ayant expiré.

Remarque

Quand vous utilisez Appcmd.exe pour configurer l'élément <sessionState> au niveau global dans IIS 8, spécifiez /commit:WEBROOT dans la commande pour que les modifications soient apportées au fichier Web.config racine au lieu de ApplicationHost.config.

Pour configurer le mode cookie URI pour l'état de session, utilisez la syntaxe suivante :

appcmd set config /commit:WEBROOT /section:sessionState /cookieless:UseUri /regenerateExpiredSessionId:true|false

La variable cookieless:UseUri configure IIS 8 pour utiliser le mode cookie URI pour l’état de session. La variable regenerateExpiredSessionId:true|false active ou désactive la régénération des ID de session ayant expiré.

Remarque

Quand vous utilisez Appcmd.exe pour configurer l'élément <sessionState> au niveau global dans IIS 8, spécifiez /commit:WEBROOT dans la commande pour que les modifications soient apportées au fichier Web.config racine au lieu de ApplicationHost.config.

2.2. Paramètres de pages et de contrôles

Cette section décrit comment configurer les paramètres de pages et de contrôles ASP.NET à l'aide de l'interface utilisateur ou de la ligne de commande du Gestionnaire des services Internet (IIS).

Remarque

Ces paramètres s'appliquent uniquement à Web Forms ASP.NET. Elles ne s’appliquent pas aux pages Web ASP.NET MVC ou ASP.NET.

Modifier des pages et des contrôles

Vous pouvez modifier les paramètres des pages et des contrôles existants et les modifications sont reflétées dans le fichier Web.config.

Pour modifier les paramètres des pages et des contrôles à l'aide de l'interface utilisateur

  1. Ouvrez le gestionnaire IIS et accédez au niveau que vous souhaitez gérer.
  2. Dans l'affichage Fonctionnalités, double-cliquez sur Pages et contrôles.
  3. Dans la page Pages et contrôles, modifiez les paramètres selon vos besoins.
  4. Lorsque vous avez terminé, cliquez sur Appliquer dans le volet Actions .

Pour modifier les paramètres des pages et des contrôles à l'aide de la ligne de commande

Pour activer ou désactiver la mise en mémoire tampon de la sortie de page, utilisez la syntaxe suivante :

appcmd set config /commit:WEBROOT /section:pages /buffer:true|false

La variable buffer:true active la mise en mémoire tampon de la sortie de page. Par défaut, il s’agit de true.

Ajouter un contrôle personnalisé

Dans Planification d’un site Web ASP.NET sur IIS, vous avez pris les décisions de conception suivantes pour chaque contrôle personnalisé que vous souhaitez ajouter :

  • Vous avez spécifié le préfixe de balise du contrôle.
  • Spécifiez l’espace de noms .NET du contrôle.
  • Vous avez spécifié l'assembly dans lequel figure le contrôle.

Pour ajouter un contrôle personnalisé à l'aide de l'interface utilisateur

  1. Ouvrez le gestionnaire IIS et accédez au niveau que vous souhaitez gérer.
  2. Dans l'affichage Fonctionnalités, double-cliquez sur Pages et contrôles.
  3. Dans le volet Actions, cliquez sur Inscrire des contrôles.
  4. Dans le volet Actions, cliquez sur Ajouter un contrôle personnalisé.
  5. Dans la boîte de dialogue Ajouter un contrôle personnalisé, tapez un préfixe de balise dans la zone de texte Préfixe.
  6. Dans la zone de texte Espace de noms, tapez l'espace de noms auquel appartient le contrôle personnalisé. Il s'agit de l'espace de noms qui a été spécifié dans le code d'application.
  7. Dans la zone de texte Assembly, tapez le nom de la source ou de l'assembly pour le contrôle personnalisé, puis cliquez sur OK.

Pour ajouter un contrôle personnalisé à l'aide de la ligne de commande

Pour ajouter un contrôle personnalisé, utilisez la syntaxe suivante :

appcmd set config /commit:WEBROOT /section:system.web/pages /+"controls.[assembly='string', namespace='string', src='string', tagName='string', tagPrefix='string']"

La variable assembly='string' est le nom de l'assembly qui contient l'implémentation du contrôle COM et exige que l'attribut namespace soit également défini. La variable namespace='string' est l'espace de noms qui est associé au préfixe de balise et exige que l'attribut assembly soit également défini, si le contrôle COM ne se trouve pas dans le répertoire de code d'application. La variable src='string' est le nom du fichier qui contient le contrôle utilisateur et exige que l'attribut tagName soit également défini. La variable tagName='string' est le nom du contrôle à utiliser dans la page et exige que l'attribut src soit également défini. La variable tagPrefix='string' est le préfixe de balise qui est mappé à un fichier source ou à un espace de noms et un assembly. Cet attribut exige l'une des combinaisons d'autres attributs suivantes :

  • namespace pour définir un contrôle COM, si le contrôle est dans le répertoire de code d'application.
  • namespace et assembly pour définir un contrôle COM.
  • tagName et src pour définir un contrôle utilisateur.

Par exemple, pour ajouter un contrôle personnalisé qui utilise la source spécifiée pour un contrôle utilisateur, tapez la commande suivante à l'invite de commandes et appuyez sur Entrée :

appcmd set config /commit:WEBROOT /section:system.web/pages /+"controls.[tagPrefix='MyTag', tagName='MyControl', src='controls/MyControl.asx']"

Remarque

Quand vous utilisez Appcmd.exe pour configurer l'élément <controls> au niveau global dans IIS 8, spécifiez /commit:WEBROOT dans la commande pour que les modifications soient apportées au fichier Web.config racine au lieu de ApplicationHost.config.

2.3. Paramètres de l’application

Cette section décrit comment configurer les paramètres d'application à l'aide de l'interface utilisateur ou de la ligne de commande du Gestionnaire des services Internet (IIS).

Dans Planifier un site Web ASP.NET sur IIS, vous avez pris les décisions de conception suivantes pour chaque paramètre d'application que vous souhaitez configurer :

  1. Spécifiez un nom pour le paramètre.
  2. Spécifiez une valeur pour le paramètre.

Pour créer un paramètre d'application à l'aide de l'interface utilisateur

  1. Ouvrez le gestionnaire IIS et accédez au niveau que vous souhaitez gérer.
  2. Dans l'affichage Fonctionnalités, double-cliquez sur Paramètres d'application.
  3. Dans le volet Actions, cliquez sur Ajouter.
  4. Dans la boîte de dialogue Ajouter un paramètre d'application, tapez un nom pour le paramètre d'application dans la zone de texte Nom.
  5. Dans la boîte de dialogue Ajouter un paramètre d'application, tapez une valeur pour le paramètre d'application dans la zone de texte Valeur, puis cliquez sur OK.

Pour créer un paramètre d'application à l’aide de la ligne de commande

Pour ajouter un paramètre d'application, utilisez la syntaxe suivante :

appcmd set config /commit:MACHINE /section:appSettings /+"[key='string', value='string']"

La variable key=string est le nom du paramètre d’application et la variable value=string est la valeur du paramètre d’application. Par exemple, pour ajouter un paramètre d'application pour le nom de votre application, tapez la commande suivante à l'invite de commandes et appuyez sur Entrée :

appcmd set config /commit:MACHINE /section:appSettings /+"[key='Application Name', value='MyApplication']"

2.4. Paramètres de compilation .NET

Modifiez les paramètres de compilation .NET dans IIS 8 lorsque vous souhaitez contrôler la façon dont ASP.NET code est compilé. Cette section décrit comment modifier les paramètres de compilation de votre application ASP.NET.

Pour configurer les paramètres de compilation .NET à l'aide de l'interface utilisateur

  1. Ouvrez le gestionnaire IIS et accédez au niveau que vous souhaitez gérer.
  2. Dans l'affichage Fonctionnalités, double-cliquez sur Compilation .NET.
  3. Dans la page Compilation .NET, modifiez les paramètres selon vos besoins.
  4. Lorsque vous avez terminé, cliquez sur Appliquer dans le volet Actions .

Pour configurer les paramètres de compilation .NET à l'aide de la ligne de commande

Pour activer ou désactiver la compilation par lots pour un site, utilisez la syntaxe suivante :

appcmd set config /commit:WEBROOT /section:compilation /batch:true|false

La variable batch:true active la compilation par lots et la variable batch:false désactive la compilation par lots. La valeur par défaut est true.

Pour modifier la taille de fichier maximale (en Ko) de la compilation par lots, utilisez la syntaxe suivante :

appcmd set config /commit:WEBROOT /section:compilation /maxBatchGeneratedFileSize:int

La variable int est la taille de fichier maximale (en Ko). La valeur par défaut est 1000.

Pour spécifier le nombre maximal de pages par compilation par lots pour un site, utilisez la syntaxe suivante :

appcmd set config /commit:WEBROOT /section:compilation /maxBatchSize:int

La variable int est le nombre maximal de pages pour chaque compilation par lots.

Pour définir le délai d'expiration, en secondes, pour la compilation par lots pour un site, utilisez la syntaxe suivante :

appcmd set config /commit:WEBROOT /section:compilation /batchTimeout:timeSpan

La variable timeSpan est le délai d’expiration en secondes pour la compilation par lots.

Pour spécifier la compilation en mode debug ou final pour un site, utilisez la syntaxe suivante :

appcmd set config /commit:WEBROOT /section:compilation /debug:true|false

La variable debug:true active la compilation des fichiers binaires de débogage et la variable debug:false active la compilation des fichiers binaires de vente au détail. La valeur par défaut est false.

Pour spécifier le nombre de fois que les ressources peuvent être recompilées de manière dynamique avant le redémarrage d'une application pour un site, utilisez la syntaxe suivante :

appcmd set config /commit:WEBROOT /section:compilation /numRecompilesBeforeAppRestart:int

La variable int est le nombre de fois que les ressources sont recompilées de manière dynamique avant le redémarrage de l'application. La valeur par défaut est 15.

Pour activer ou désactiver le pragma de ligne d'URL pour un site, utilisez la syntaxe suivante :

appcmd set config /commit:WEBROOT /section:compilation /urlLinePragmas:true|false

La variable urlLinePragmas:true active le pragma de ligne d’URL et la variable urlLinePragmas:false désactive le pragma de ligne d’URL. La valeur par défaut est false.

Pour activer ou désactiver la compilation explicite Visual Basic pour un site, utilisez la syntaxe suivante :

appcmd set config /commit:WEBROOT /section:compilation /explicit:true|false

La variable explicit:true active la compilation explicite Visual Basic et la variable explicit:false désactive la compilation explicite. La valeur par défaut est false.

Pour activer ou désactiver la compilation stricte Visual Basic pour un site, utilisez la syntaxe suivante :

appcmd set config /commit:WEBROOT /section:compilation /strict:true|false

La variable strict:true active la compilation stricte Visual Basic et la variable strict:false désactive la compilation stricte. La valeur par défaut est false.

Pour ajouter une directive de traitement de compilation ASP.NET pour un site, utilisez la syntaxe suivante :

appcmd set config /commit:WEBROOT /section:compilation /+"assemblies.[assembly='string']"

La variable string est la directive de traitement de compilation ASP.NET.

Pour supprimer une directive de traitement de compilation ASP.NET pour un site, utilisez la syntaxe suivante :

appcmd set config /commit:WEBROOT /section:compilation /-"assemblies.[assembly='string']"

La variable string est la directive de traitement de compilation ASP.NET.

Pour supprimer une directive de traitement de compilation ASP.NET pour un site, utilisez la syntaxe suivante :

appcmd set config /commit:WEBROOT /section:compilation /-"assemblies.[assembly='string']"

La variable string est la directive de traitement de compilation ASP.NET.

Pour modifier le langage de programmation par défaut utilisé dans les fichiers de compilation dynamique d'un site, utilisez la syntaxe suivante :

appcmd set config /commit:WEBROOT /section:compilation /defaultLanguage:string

La variable string représente le langage de programmation par défaut. La valeur par défaut est vb. Par exemple, pour modifier le langage de programmation par défaut utilisé dans les fichiers de compilation dynamique de Visual Basic en C#, tapez la commande suivante à l'invite de commandes et appuyez sur Entrée :

appcmd set config /commit:WEBROOT /section:compilation /defaultLanguage:c#

Pour spécifier le répertoire à utiliser pour le stockage temporaire des fichiers au cours de la compilation pour un site, utilisez la syntaxe suivante :

appcmd set config /commit:WEBROOT /section:compilation /tempDirectory:string

La variable string est le chemin d’accès au répertoire.

Remarque

Quand vous utilisez Appcmd.exe pour configurer l'élément <compilation> au niveau global dans IIS 8, spécifiez /commit:WEBROOT dans la commande pour que les modifications soient apportées au fichier Web.config racine au lieu de ApplicationHost.config.

2.5. Paramètres de globalisation .NET

Cette section décrit comment modifier les paramètres de globalisation de votre application ASP.NET à l'aide de l'interface utilisateur ou de la ligne de commande du Gestionnaire des services Internet (IIS).

Pour modifier les paramètres de globalisation .NET à l'aide de l'interface utilisateur

  1. Ouvrez le gestionnaire IIS et accédez au niveau que vous souhaitez gérer.
  2. Dans l'affichage Fonctionnalités, double-cliquez sur Globalisation .NET.
  3. Dans la page Globalisation .NET, dans la feuille de propriétés, sélectionnez le paramètre global à modifier et sélectionnez une valeur dans la liste déroulante.
  4. Dans le volet Actions, cliquez sur Appliquer.

Pour modifier les paramètres de globalisation .NET à l'aide de la ligne de commande

Pour modifier la culture par défaut pour le traitement des demandes Web, utilisez la syntaxe suivante :

appcmd set config /commit:WEBROOT /section:globalization /culture:string

La variable chaîne est la culture par défaut pour le traitement des demandes Web. Par exemple, pour modifier la culture par défaut pour le traitement des demandes Web et sélectionner l'anglais (États-Unis), tapez la commande suivante à l'invite de commandes et appuyez sur Entrée :

appcmd set config /commit:WEBROOT /section:globalization /culture:en-us

Remarque

Quand vous utilisez Appcmd.exe pour configurer l'élément <globalization> au niveau global dans IIS 8, spécifiez /commit:WEBROOT dans la commande pour que les modifications soient apportées au fichier Web.config racine au lieu de ApplicationHost.config.

Pour activer ou désactiver la culture basée sur le client, utilisez la syntaxe suivante :

appcmd set config /commit:WEBROOT /section:globalization /enableClientBasedCulture:true|false

La variable enableClientBasedCulture:true active la culture basée sur le client et la variable enableClientBasedCulture:false désactive la culture basée sur le client. Par défaut, il s’agit de false.

Pour modifier la culture par défaut pour le traitement des recherches de ressources qui dépendent des paramètres régionaux, utilisez la syntaxe suivante :

appcmd set config /commit:WEBROOT /section:globalization /uiCulture:string

La variable string est la culture par défaut pour le traitement des recherches de ressources qui dépendent des paramètres régionaux.

Pour modifier la culture par défaut pour le traitement des recherches de ressources qui dépendent des paramètres régionaux, utilisez la syntaxe suivante :

appcmd set config /commit:WEBROOT /section:globalization /uiCulture:string

La variable string est la culture par défaut pour le traitement des recherches de ressources qui dépendent des paramètres régionaux.

Pour modifier l'encodage par défaut lors de l'analyse des fichiers .aspx, .asmx et .asax, utilisez la syntaxe suivante :

appcmd set config /commit:WEBROOT /section:globalization /fileEncoding:string

La variable string est l'encodage par défaut à utiliser lors de l'analyse des fichiers .aspx, .asmx et .asax.

Pour modifier l'encodage d'en-tête des réponses, utilisez la syntaxe suivante :

appcmd set config /commit:WEBROOT /section:globalization /responseHeaderEncoding:string

La variable string est l'encodage d'en-tête utilisé pour les réponses. La valeur par défaut est UTF-8.

Pour modifier l'encodage du contenu des réponses, utilisez la syntaxe suivante :

appcmd set config /commit:WEBROOT /section:globalization /responseEncoding:string

La variable string est l'encodage du contenu utilisé pour les réponses. La valeur par défaut est UTF-8.