ClientTargetCollection.Clear Méthode

Définition

Espace de noms:
System.Web.Configuration
Assembly:
System.Web.dll

Supprime tous les ClientTarget 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 ClientTarget objets de la ClientTargetCollection collection.

Pour plus d’informations sur l’obtention de la collection, consultez l’exemple de code dans la vue d’ensemble de la ClientTargetCollection classe.


           // Clear the client target collection.
           clientTargets.Clear();

           // Update the configuration file.
           if (!clientTargetSection.IsReadOnly())
             configuration.Save();

' Clear the client target collection.
clientTargets.Clear()

' Update the configuration file.
If Not clientTargetSection.IsReadOnly() Then
    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 la ConfigurationSaveMode valeur choisie. Pour mettre à jour le fichier de configuration, vous utilisez l’une des deux méthodes suivantes : Configuration.Save ou Configuration.Save.

Note

L’appel Configuration.Save équivaut à appeler Save lorsque la ConfigurationSaveMode valeur est modifiée.

Si vous utilisez la Configuration.Save méthode, les conditions suivantes s’appliquent :

  • Si vous passez la valeur ou Full le Modified 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 Minimal paramètre, une série d’éléments remove est ajoutée à 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. Avec la Minimal valeur d’énumération, une propriété supplémentaire sur la collection affecte ce qui est sérialisé dans le fichier de configuration. La propriété est EmitClear et est false par défaut. L’une des conditions suivantes s’applique :

    • Quand EmitClear la valeur est définie true, un clear é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.

    • Lorsqu’il EmitClear est défini falsesur , 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. Elle 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.

Note

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

S’applique à

Voir aussi