CustomErrorCollection.Clear Метод

Определение

Пространство имен:

System.Web.Configuration

Сборка:

System.Web.dll

Удаляет все CustomError объекты из коллекции.

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.

Note

Вызов Save эквивалентен вызову Save.

Если используется Saveметод ., применяются следующие условия.

• При передаче Full значения Modified параметра clear элемент вставляется в clientTarget раздел файла конфигурации на текущем уровне иерархии.

• При передаче значения параметра Minimal ряд элементов remove добавляются в элемент clientTarget (схема параметров ASP.NET) файла конфигурации на текущем уровне иерархии. Каждая из них удаляет все ссылки на элемент, определенный add в родительском файле конфигурации на более высоком уровне иерархии. При использовании Minimalв коллекции есть одно дополнительное свойство, которое влияет на сериализацию в файл конфигурации: EmitClearкоторый по умолчанию.false В данном случае действуют следующие условия.

  • EmitClear Если задано значение true, clear элемент вставляется в clientTarget раздел файла конфигурации на текущем уровне иерархии. При этом удаляются все ссылки на add элементы, определенные в родительских файлах конфигурации на более высоких уровнях иерархии.

  • EmitClear Если флаг заданfalse, clear элемент удаляется из clientTarget раздела файла конфигурации на текущем уровне иерархии, если он существует.

Метод Clear фактически удаляет add элементы, определенные в clientTarget разделе файла конфигурации на текущем уровне иерархии. Он также удаляет все ссылки на элементы добавления, определенные в родительских файлах конфигурации на более высоких уровнях иерархии.

Note

Элементы add не удаляются из clientTarget раздела родительских файлов конфигурации.