UrlMappingCollection.Clear Méthode

Définition

Espace de noms:

System.Web.Configuration

Assembly:

System.Web.dll

Supprime tous les objets UrlMapping de la collection.

public:
 void Clear();

public void Clear ();

member this.Clear : unit -> unit

Public Sub Clear ()

Exemples

L’exemple de code suivant supprime tous les UrlMapping objets du UrlMappingCollection.

Reportez-vous à l’exemple de code de la UrlMappingCollection rubrique de classe pour savoir comment obtenir la collection.

// Clear the url mapping collection.
urlMappings.Clear();

// Update the configuration file.

// Define the save modality.
ConfigurationSaveMode saveMode =
  ConfigurationSaveMode.Minimal;

urlMappings.EmitClear =
   Convert.ToBoolean(parm2);

if (parm1 == "none")
{
  if (!urlMappingSection.IsReadOnly())
    configuration.Save();
  msg = String.Format(
  "Default modality, EmitClear:      {0}",
  urlMappings.EmitClear.ToString());
}
else
{
  if (parm1 == "full")
    saveMode = ConfigurationSaveMode.Full;
  else
    if (parm1 == "modified")
      saveMode = ConfigurationSaveMode.Modified;

  if (!urlMappingSection.IsReadOnly())
    configuration.Save(saveMode);

  msg = String.Format(
   "Save modality:      {0}",
   saveMode.ToString());
}

' Clear the url mapping collection.
urlMappings.Clear()

' Update the configuration file.
' Define the save modality.
Dim saveMode _
As ConfigurationSaveMode = _
ConfigurationSaveMode.Minimal

urlMappings.EmitClear = _
Convert.ToBoolean(parm2)

If parm1 = "none" Then
    If Not urlMappingSection.IsReadOnly() Then
        configuration.Save()
    End If
    msg = String.Format( _
    "Default modality, EmitClear:      {0}", _
    urlMappings.EmitClear.ToString())
Else
    If parm1 = "full" Then
        saveMode = ConfigurationSaveMode.Full
    ElseIf parm1 = "modified" Then
        saveMode = ConfigurationSaveMode.Modified
    End If
    If Not urlMappingSection.IsReadOnly() Then
        configuration.Save(saveMode)
    End If
    msg = String.Format( _
    "Save modality:      {0}", _
    saveMode.ToString())
End If

Remarques

Si vous enregistrez le fichier de configuration après avoir appelé la Clear méthode, le résultat dépend de l’élément choisi ConfigurationSaveMode.

La liste suivante décrit les conditions qui s’appliquent si vous utilisez la Save méthode pour enregistrer le fichier :

• Si vous passez Full ou ConfigurationSaveMode.Modified en tant que valeur de paramètre, un clear élément est inséré dans la urlMappings section du fichier de configuration au niveau de la hiérarchie actuelle.

• Si vous passez Minimal comme valeur de paramètre, une série d’éléments remove est ajoutée au urlMappings fichier de configuration au niveau de la hiérarchie actuelle. Ces remove éléments suppriment toutes les références aux add éléments définis dans les fichiers de configuration parent à des niveaux supérieurs dans la hiérarchie. Avec la Minimal valeur d’énumération, il existe une propriété supplémentaire sur la collection qui affecte ce qui est sérialisé dans le fichier de configuration. La propriété est et est EmitClear false par défaut. L’une des conditions suivantes s’applique :

  • EmitClear défini sur true. Un clear élément est inséré dans la urlMappings section du fichier de configuration au niveau de la hiérarchie actuelle. Cela supprime toutes les références aux add éléments définis dans les fichiers de configuration parent à des niveaux supérieurs dans la hiérarchie.

  • EmitClear l’indicateur est défini sur false. Cela a pour effet de supprimer l’élément clear de la urlMappings section du fichier de configuration au niveau de la hiérarchie actuelle, s’il existe.

La Clear méthode supprime réellement les add éléments définis dans la urlMappings section du fichier de configuration au niveau de la hiérarchie actuelle. Il supprime également toutes les références aux add éléments définis dans les fichiers de configuration parent à des niveaux supérieurs dans la hiérarchie, mais ne les supprime pas.

Voir aussi

• UrlMapping
• UrlMappingsSection