add, élément de urlMappings (Schéma des paramètres urlMappings)

Mise à jour : novembre 2007

Ajoute l'objet UrlMapping spécifié à la collection.

configuration, élément (Schéma des paramètres généraux)
  system.web, élément (Schéma des paramètres ASP.NET)
    urlMappings, élément (Schéma des paramètres ASP.NET)
      add, élément de urlMappings (Schéma des paramètres urlMappings)

<add url="String" 
     mappedUrl="String"/>

Attributs et éléments

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

Attributs

Attribut	Description
url	Attribut String requis. Définit l'URL relative à l'application des requêtes entrantes qui seront re-mappées à une URL différente par le runtime ASP.NET.
mappedURL	Attribut String requis. Définit l'URL relative à l'application qui est la cible d'un mappage. Remarque : mappedUrl doit être une URL relative à l'application. Au moment de l'exécution, mappedUrl est converti en un chemin d'accès virtuel absolu basé sur la racine de l'application en cours d'exécution. mappedUrl peut inclure des informations sur la chaîne de requête. mappedUrl est supprimé afin d'éliminer tout espace de début ou de fin.

Éléments enfants

Aucun.

Éléments parents

Élément	Description
configuration	Élément racine requis de chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.
system.web	Spécifie l'élément racine pour les paramètres de configuration ASP.NET dans un fichier de configuration. Contient des éléments de configuration qui configurent les applications Web ASP.NET et contrôlent le comportement des applications.
urlMappings	Définit le mappage d'une URL vers une autre URL mappée.

Exemple

L'exemple suivant ajoute un objet UrlMapping à une application ASP.NET.

Remarque :
Par nature, vous ne pouvez pas mapper à la même page. Si vous le faites, les informations d'état sont perdues dans les publications.

<urlMappings enabled="true">
  <add url="~/Home.aspx" mappedUrl="~/Default.aspx?tab=home" />
</urlMappings>

Informations sur les éléments

Gestionnaire de section de configuration	System.Web.Configuration.UrlMappingsSection
Membre de configuration	SystemWebSectionGroup.UrlMappings UrlMappingsSection.UrlMappings
Emplacements configurables	Machine.config Web.config de niveau racine Web.config de niveau application
Configuration requise	IIS version 5.0, IIS version 5.1 ou IIS version 6.0 .NET Framework version 2.0 Visual Studio 2005

Voir aussi

Tâches

Comment : configurer des répertoires spécifiques à l'aide des paramètres d'emplacement

Comment : verrouiller des paramètres de configuration ASP.NET

Concepts

Vue d'ensemble de la configuration ASP.NET

Scénarios de configuration ASP.NET

Sécurisation de la configuration ASP.NET

Référence

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

configuration, élément (Schéma des paramètres généraux)

clear, élément de urlMappings (Schéma des paramètres ASP.NET)

remove, élément de urlMappings (Schéma des paramètres ASP.NET)

System.Configuration

System.Web.Configuration

Autres ressources

Paramètres généraux de configuration (ASP.NET)

Paramètres de configuration ASP.NET

Administration de sites Web ASP.NET

API de configuration ASP.NET