ClientTargetCollection.Clear Метод

Определение

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

public void Clear ();

Примеры

В следующем примере кода удаляются ClientTarget все объекты из ClientTargetCollection коллекции.

Сведения о том, как получить коллекцию, см. в примере кода в обзоре ClientTargetCollection класса .


           // Clear the client target collection.
           clientTargets.Clear();

           // Update the configuration file.
           if (!clientTargetSection.IsReadOnly())
             configuration.Save();

Комментарии

Результат обновления файла конфигурации после вызова 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 раздела родительских файлов конфигурации.

Применяется к

Продукт Версии
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

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