ClientTargetCollection.Clear Method ()

 

Removes all the ClientTarget objects from the collection.

Namespace:   System.Web.Configuration
Assembly:  System.Web (in System.Web.dll)

member Clear : unit -> unit

The result of updating the configuration file after calling the Clear method is dependent upon the ConfigurationSaveMode value chosen. To update the configuration file you use one of these two methods: Configuration.Save or Configuration.Save.

System_CAPS_noteNote

Calling Configuration.Save is equivalent to calling Save when the ConfigurationSaveMode value is modified.

If you use the Configuration.Save method, the following conditions apply:

  • If you pass the Full or Modified parameter value, then a clear element is inserted into the clientTarget section of the configuration file at the current hierarchy level.

  • If you pass the Minimal parameter value, a series of remove elements are added to the clientTarget section of the configuration file at the current hierarchy level. This removes all references to the add elements defined in the parent configuration files at higher levels in the hierarchy. With the Minimal enumeration value, one additional property on the collection affects what gets serialized to the configuration file. The property is EmitClear and is false by default. One of the following conditions applies:

    • When EmitClear is set to true, a clear element is inserted into the clientTarget section of the configuration file at the current hierarchy level. This removes all references to the add elements defined in the parent configuration files at higher levels in the hierarchy.

    • When EmitClear is set to false, the clear element is removed from the clientTarget section of the configuration file at the current hierarchy level, if it exists.

The Clear method actually deletes the add elements defined in the clientTarget section of the configuration file at the current hierarchy level. It also removes all references to the add elements defined in the parent configuration files at higher levels in the hierarchy.

System_CAPS_noteNote

The add elements are not deleted from the clientTarget section of the parent configuration files.

The following code example removes all the ClientTarget objects from the ClientTargetCollection collection.

For information about how to get the collection, see the code example in the ClientTargetCollection class overview.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 2.0
Return to top
Show: