CustomErrorCollection.Clear Méthode

Définition

Espace de noms:

System.Web.Configuration

Assembly:

System.Web.dll

Supprime tous les objets CustomError 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 du ConfigurationSaveMode choisi. Pour mettre à jour le fichier de configuration, vous utilisez l’une de ces deux surcharges : Save et Save.

Notes

Appeler Save équivaut à appeler Save.

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

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

• Si vous transmettez la valeur du Minimal paramètre, une série d’éléments remove est ajoutée à l’élément clientTarget (ASP.NET schéma paramètres) 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 l’élément EmitCleartrueest défini sur , clear 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 éléments définis dans les add fichiers de configuration parent aux niveaux supérieurs de la hiérarchie.

  • Si l’indicateur EmitClear est défini sur false, l’élément clear est supprimé de la clientTarget section du 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. Il supprime également toutes les références aux éléments d’ajout définis dans les fichiers de configuration parent aux niveaux supérieurs de la hiérarchie.

Notes

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