ClientTargetCollection.Clear 方法

public:
 void Clear();

public void Clear();

member this.Clear : unit -> unit

Public Sub Clear ()

示例

下面的代码示例从集合中删除所有 ClientTarget 对象 ClientTargetCollection 。

有关如何获取集合的信息，请参阅类概述中的 ClientTargetCollection 代码示例。

           // 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

注解

调用 Clear 该方法后更新配置文件的结果取决于 ConfigurationSaveMode 所选的值。 若要更新配置文件，请使用以下两种方法之一： Configuration.Save 或 Configuration.Save。

如果使用此方法 Configuration.Save ，则适用以下条件：

• 如果传递或FullModified参数值，则会clear将元素插入到clientTarget配置文件的当前层次结构级别的节中。

• 如果传递 Minimal 参数值，会将一系列 remove 元素添加到 clientTarget 当前层次结构级别的配置文件部分。 这会删除对 add 层次结构中较高级别的父配置文件中定义的元素的所有引用。 Minimal使用枚举值时，集合上的一个附加属性会影响序列化到配置文件的内容。 该属性默认为 EmitClear 和 false 默认属性。 以下条件之一适用：

  • 设置为 /> 时，元素将插入到配置文件的当前层次结构级别的节中。 这会删除对 add 层次结构中较高级别的父配置文件中定义的元素的所有引用。

  • 设置为 /> 时，将从配置文件的当前层次结构级别的节中删除该元素（如果存在）。

该方法 Clear 实际上删除 add 在当前层次结构级别的配置文件节中 clientTarget 定义的元素。 它还会删除对 add 层次结构中较高级别的父配置文件中定义的元素的所有引用。

另请参阅

• ClientTarget
• ClientTargetSection