ClientTargetCollection.Clear Méthode

Définition

Espace de noms:

System.Web.Configuration

Assembly:

System.Web.dll

Supprime tous les objets ClientTarget 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.

Notes

Appeler 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 transmettez la valeur du Full 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 à 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. 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 :

  • Lorsque EmitClear a la truevaleur , 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 éléments définis dans les add fichiers de configuration parent aux niveaux supérieurs de la hiérarchie.

  • Lorsque EmitClear a la falsevaleur , 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éfinis dans les add 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.

Voir aussi

• ClientTarget
• ClientTargetSection