CustomErrorCollection.Clear Méthode

Définition

Espace de noms:

System.Web.Configuration

Assembly:

System.Web.dll

Supprime tous les CustomError objets 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 CustomError objets de la CustomErrorCollection collection. Reportez-vous à l’exemple de code dans la CustomErrorCollection rubrique de classe pour savoir comment obtenir la collection.

// Using the Clear method.
if (!customErrorsSection.SectionInformation.IsLocked)
{
    // Execute the Clear method.
    customErrorsCollection.Clear();
    configuration.Save();
}

' Using the Clear method.
If Not customErrorsSection.SectionInformation.IsLocked Then
   ' Execute the Clear method.
   customErrorsCollection.Clear()
   configuration.Save()
End If

Remarques

Le résultat de la mise à jour du fichier de configuration après l’appel de la Clear méthode dépend de l’option ConfigurationSaveMode choisie. Pour mettre à jour le fichier de configuration, vous utilisez l’une des deux surcharges suivantes : Save et Save.

Note

Appeler Save équivaut à appeler Save.

Si vous utilisez la Saveméthode ., les conditions suivantes s’appliquent.

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

• Si vous passez la valeur du paramètre Minimal, une série d’éléments remove est ajoutée à l’élément clientTarget (schéma ASP.NET Settings) du fichier de configuration au niveau de la hiérarchie actuelle. Chacune supprime toutes les références à un add élément défini dans un fichier de configuration parent à un niveau supérieur dans la hiérarchie. Lorsque vous utilisez Minimal, il existe une propriété supplémentaire sur la collection qui affecte ce qui est sérialisé dans le fichier de configuration : EmitClear, qui est false par défaut. Les conditions suivantes s’appliquent.

  • Si la EmitClear valeur est définie true, clear l’élément est inséré dans la clientTarget 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 aux niveaux supérieurs de la hiérarchie.

  • Si l’indicateur EmitClear est défini falsesur , l’élément clear est supprimé de la section du clientTarget fichier de configuration au niveau de la hiérarchie actuelle, s’il existe.

La Clear méthode supprime en fait les add éléments définis dans la clientTarget section du fichier de configuration au niveau de la hiérarchie actuelle. Elle supprime également toutes les références aux éléments d’ajout définis dans les fichiers de configuration parent à des niveaux supérieurs dans la hiérarchie.

Note

Les add éléments ne sont pas supprimés de la clientTarget section des fichiers de configuration parent.