IConfigurationSectionHandler Interfejs

Definicja

Obsługuje dostęp do niektórych sekcji konfiguracji.

C#
public interface IConfigurationSectionHandler
Pochodne

Uwagi

Ważne

IConfigurationSectionHandler jest przestarzały w programie .NET Framework 2.0 lub nowszym. Ale, ponieważ jest używany wewnętrznie, został zachowany. Przykład można znaleźć w sekcji Instrukcje: tworzenie niestandardowych sekcji konfiguracji przy użyciu programu IConfigurationSectionHandler. Jeśli używasz poprzedniego przykładu, skompiluj go przy użyciu programu .NET Framework w wersji 1.0 lub 1.1.

W programie .NET Framework w wersji 2.0 lub nowszej ConfigurationSection należy zamiast tego pochodzić z klasy w celu zaimplementowania powiązanej procedury obsługi sekcji konfiguracji. Przykład można znaleźć w sekcji Instrukcje: tworzenie niestandardowych sekcji konfiguracji przy użyciu konfiguracjiSection.

IConfigurationSectionHandler Wystąpienia klasy muszą być bezpieczne wątkami i bezstanowe. Metoda Create musi być wywoływana z wielu wątków jednocześnie.

Ponadto obiekt konfiguracji wygenerowany przez metodę Create musi być bezpieczny wątkowo i niezmienny. Ponieważ obiekty konfiguracji są buforowane przez system konfiguracji, ważne jest, aby nie modyfikować argumentu nadrzędnego do Create metody . Jeśli na przykład zwracana wartość elementu Create jest tylko niewielką modyfikacją elementu nadrzędnego, rzeczywiste modyfikacje muszą zostać wprowadzone na klonie elementu nadrzędnego, a nie oryginalnego.

Metody

Create(Object, Object, XmlNode)

Tworzy procedurę obsługi sekcji konfiguracji.

Dotyczy

Produkt Wersje
.NET 8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Framework 1.1, 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
.NET Standard 2.0 (package-provided)
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10