CustomErrorCollection.Clear 方法

public:
 void Clear();

public void Clear();

member this.Clear : unit -> unit

Public Sub Clear ()

示例

下面的代码示例从集合中删除所有 CustomError 对象 CustomErrorCollection 。 请参阅类主题中的 CustomErrorCollection 代码示例，了解如何获取集合。

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

注解

调用 Clear 该方法后更新配置文件的结果取决于 ConfigurationSaveMode 所选方法。 若要更新配置文件，请使用以下两个重载之一： Save 和 Save。

如果使用 Save.method，则适用以下条件。

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

• 如果传递 Minimal 参数值，则当前层次结构级别的配置文件的 remove 元素将一系列 remove 元素添加到 clientTarget 元素（ASP.NET 设置架构）。 每个元素都将删除对 add 层次结构中较高级别的父配置文件中定义的元素的所有引用。 使用 Minimal时，集合上有一个附加属性，该属性会影响序列化到配置文件的内容： EmitClear默认情况下 false ， 以下条件适用。

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

  • EmitClear如果标志设置为false该标志，则会clear从clientTarget当前层次结构级别的配置文件部分中删除该元素（如果存在）。

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