ClientTargetCollection.Clear Метод

Определение

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

System.Web.Configuration

Сборка:

System.Web.dll

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

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 эквивалентен вызову Save при ConfigurationSaveMode изменении значения.

При использовании Configuration.Save метода применяются следующие условия:

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

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

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

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

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

Примечание

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

См. также раздел

• ClientTarget
• ClientTargetSection