WebConfigurationManager Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.Configuration

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Zapewnia dostęp do plików konfiguracji w miarę ich stosowania do aplikacji internetowych.

public ref class WebConfigurationManager abstract sealed

public static class WebConfigurationManager

type WebConfigurationManager = class

Public Class WebConfigurationManager

Dziedziczenie: Object
WebConfigurationManager

Przykłady

W poniższym przykładzie pokazano, jak uzyskać dostęp do informacji o konfiguracji za pomocą polecenia

GetSection Metoda.


// Show how to use the GetSection(string). 
// to access the connectionStrings section.
static void GetConnectionStringsSection()
{

    // Get the connectionStrings section.
    ConnectionStringsSection connectionStringsSection =
        WebConfigurationManager.GetSection("connectionStrings")
        as ConnectionStringsSection;

    // Get the connectionStrings key,value pairs collection.
    ConnectionStringSettingsCollection connectionStrings =
        connectionStringsSection.ConnectionStrings;
   
    // Get the collection enumerator.
    IEnumerator connectionStringsEnum =
        connectionStrings.GetEnumerator();

    // Loop through the collection and 
    // display the connectionStrings key, value pairs.
    int i = 0;
    Console.WriteLine("[Display the connectionStrings]");
    while (connectionStringsEnum.MoveNext())
    {
        string name = connectionStrings[i].Name;
        Console.WriteLine("Name: {0} Value: {1}",
        name, connectionStrings[name]);
        i += 1;
    }

    Console.WriteLine();
}

' Show how to use the GetSection(string). 
' to access the connectionStrings section.
Shared Sub GetConnectionStringsSection()
   
   ' Get the connectionStrings section.
     Dim connectionStringsSection As ConnectionStringsSection = _
     WebConfigurationManager.GetSection("connectionStrings")
   
   ' Get the connectionStrings key,value pairs collection.
     Dim connectionStrings As ConnectionStringSettingsCollection = _
     connectionStringsSection.ConnectionStrings
   
   ' Get the collection enumerator.
     Dim connectionStringsEnum As IEnumerator = _
     connectionStrings.GetEnumerator()
   
   ' Loop through the collection and 
   ' display the connectionStrings key, value pairs.
   Dim i As Integer = 0
   Console.WriteLine("[Display the connectionStrings]")
   While connectionStringsEnum.MoveNext()
      Dim name As String = connectionStrings(i).Name
         Console.WriteLine("Name: {0} Value: {1}", _
         name, connectionStrings(name))
      i += 1
   End While
   
   Console.WriteLine()
End Sub

Uwagi

Klasa WebConfigurationManager umożliwia dostęp do informacji o komputerze i aplikacji.

Użycie WebConfigurationManager jest preferowanym sposobem pracy z plikami konfiguracji powiązanymi z aplikacjami internetowymi. W przypadku aplikacji klienckich użyj ConfigurationManager klasy .

Aplikacja może rozszerzyć System.Configuration typy lub użyć ich bezpośrednio do obsługi informacji o konfiguracji, jak wyjaśniono na poniższej liście:

Handling configuration. Aby obsłużyć informacje o konfiguracji przy użyciu typów standardowych, należy użyć jednej z następujących metod:
- Accessing a section. Aby uzyskać dostęp do informacji o konfiguracji aplikacji, należy użyć jednej z metod udostępnianych GetSection przez WebConfigurationManagerusługę . W przypadku <appSettings> obiektów i <connectionStrings>należy użyć AppSettings właściwości i ConnectionStrings . Te metody wykonują operacje tylko do odczytu, używają pojedynczego buforowanego wystąpienia konfiguracji i są obsługujące wiele elementów.
- Accessing configuration files. Aplikacja może odczytywać i zapisywać ustawienia konfiguracji na dowolnym poziomie, dla siebie lub dla innych aplikacji lub komputerów, lokalnie lub zdalnie. Należy użyć jednej z metod udostępnianych przez WebConfigurationManagerusługę open . Metody te zwracają Configuration obiekt, który z kolei udostępnia wymagane metody i właściwości do obsługi podstawowych plików konfiguracji. Te metody wykonują operacje odczytu lub zapisu i odtwarzają dane konfiguracji za każdym razem, gdy plik jest otwarty.
- Advanced configuration. Bardziej zaawansowana obsługa konfiguracji jest zapewniana przez typy SectionInformation, PropertyInformation, PropertyInformationCollection, ElementInformation, ContextInformation, ConfigurationSectionGroupi ConfigurationSectionGroupCollection.
Extending configuration standard types. Możesz również udostępnić niestandardowe elementy konfiguracji, rozszerzając standardowe typy konfiguracji, takie jak ConfigurationElement, ConfigurationElementCollection, ConfigurationPropertyi ConfigurationSection przy użyciu programowego lub przypisanego modelu. Zapoznaj się z klasą, aby zapoznać się z ConfigurationSection przykładem sposobu programowego rozszerzania standardowego typu konfiguracji. Zapoznaj się z klasą, aby zapoznać się z ConfigurationElement przykładem rozszerzania standardowego typu konfiguracji przy użyciu modelu przypisanego.

Uwagi dotyczące dziedziczenia

Klasa Configuration umożliwia programowy dostęp do edytowania plików konfiguracji. Należy użyć jednej z otwartych metod udostępnianych przez WebConfigurationManagerusługę . Metody te zwracają Configuration obiekt, który z kolei udostępnia wymagane metody i właściwości do obsługi podstawowych plików konfiguracji. Dostęp do tych plików można uzyskać do odczytu lub zapisu w następujący sposób:

Informacje o konfiguracji są używane GetSection(String) lub GetSectionGroup(String) odczytywane. Należy pamiętać, że użytkownik lub proces odczytu musi mieć następujące uprawnienia:

Uprawnienie do odczytu w pliku konfiguracji na bieżącym poziomie hierarchii konfiguracji.
Uprawnienia do odczytu dla wszystkich plików konfiguracji nadrzędnej.

Jeśli aplikacja potrzebuje dostępu tylko do odczytu do własnej konfiguracji, zaleca się użycie GetSection metod. Te metody zapewniają dostęp do buforowanych wartości konfiguracji dla bieżącej aplikacji, która ma lepszą wydajność niż Configuration klasa.

Uwaga: Jeśli używasz metody statycznej GetSection , która przyjmuje path parametr, parametr ścieżki musi odwoływać się do aplikacji, w której jest uruchomiony kod. W przeciwnym razie parametr jest ignorowany, a informacje o konfiguracji aktualnie uruchomionej aplikacji są zwracane.

Jedna z metod służy do zapisywania Save informacji o konfiguracji. Należy pamiętać, że użytkownik lub proces zapisu musi mieć następujące uprawnienia:

Uprawnienie do zapisu w pliku konfiguracji i katalogu na bieżącym poziomie hierarchii konfiguracji.
Uprawnienia do odczytu dla wszystkich plików konfiguracji.

Właściwości

AppSettings	Pobiera ustawienia aplikacji witryny sieci Web.
ConnectionStrings	Pobiera parametry połączenia witryny sieci Web.

Metody

GetSection(String)	Pobiera określoną sekcję konfiguracji z bieżącego pliku konfiguracji aplikacji internetowej.
GetSection(String, String)	Pobiera określoną sekcję konfiguracji z pliku konfiguracji aplikacji internetowej w określonej lokalizacji.
GetWebApplicationSection(String)	Pobiera określoną sekcję konfiguracji z bieżącego pliku konfiguracji aplikacji internetowej.
OpenMachineConfiguration()	Otwiera plik konfiguracji maszyny na bieżącym komputerze jako Configuration obiekt, aby umożliwić operacje odczytu lub zapisu.
OpenMachineConfiguration(String)	Otwiera plik konfiguracji maszyny na bieżącym komputerze jako Configuration obiekt, aby umożliwić operacje odczytu lub zapisu.
OpenMachineConfiguration(String, String)	Otwiera określony plik konfiguracji maszyny na określonym serwerze jako Configuration obiekt, aby umożliwić operacje odczytu lub zapisu.
OpenMachineConfiguration(String, String, IntPtr)	Otwiera określony plik konfiguracji maszyny na określonym serwerze jako Configuration obiekt przy użyciu określonego kontekstu zabezpieczeń, aby umożliwić operacje odczytu lub zapisu.
OpenMachineConfiguration(String, String, String, String)	Otwiera określony plik konfiguracji maszyny na określonym serwerze jako Configuration obiekt przy użyciu określonego kontekstu zabezpieczeń, aby umożliwić operacje odczytu lub zapisu.
OpenMappedMachineConfiguration(ConfigurationFileMap)	Otwiera plik konfiguracji maszyny jako Configuration obiekt przy użyciu określonego mapowania plików, aby umożliwić operacje odczytu lub zapisu.
OpenMappedMachineConfiguration(ConfigurationFileMap, String)	Otwiera plik konfiguracji maszyny jako Configuration obiekt przy użyciu określonego mapowania plików i lokalizacji, aby umożliwić operacje odczytu lub zapisu.
OpenMappedWebConfiguration(WebConfigurationFileMap, String)	Otwiera określony plik konfiguracji aplikacji internetowej jako Configuration obiekt przy użyciu określonego mapowania plików i ścieżki wirtualnej, aby umożliwić operacje odczytu lub zapisu.
OpenMappedWebConfiguration(WebConfigurationFileMap, String, String)	Otwiera określony plik konfiguracji aplikacji internetowej jako Configuration obiekt przy użyciu określonego mapowania plików, ścieżki wirtualnej i nazwy witryny, aby umożliwić operacje odczytu lub zapisu.
OpenMappedWebConfiguration(WebConfigurationFileMap, String, String, String)	Otwiera określony plik konfiguracji aplikacji internetowej jako Configuration obiekt przy użyciu określonego mapowania plików, ścieżki wirtualnej, nazwy witryny i lokalizacji, aby umożliwić operacje odczytu lub zapisu.
OpenWebConfiguration(String)	Otwiera plik konfiguracji aplikacji internetowej jako Configuration obiekt przy użyciu określonej ścieżki wirtualnej, aby zezwolić na operacje odczytu lub zapisu.
OpenWebConfiguration(String, String)	Otwiera plik konfiguracji aplikacji internetowej jako Configuration obiekt przy użyciu określonej ścieżki wirtualnej i nazwy witryny, aby umożliwić operacje odczytu lub zapisu.
OpenWebConfiguration(String, String, String)	Otwiera plik konfiguracji aplikacji internetowej jako Configuration obiekt przy użyciu określonej ścieżki wirtualnej, nazwy witryny i lokalizacji, aby umożliwić operacje odczytu lub zapisu.
OpenWebConfiguration(String, String, String, String)	Otwiera plik konfiguracji aplikacji internetowej jako Configuration obiekt przy użyciu określonej ścieżki wirtualnej, nazwy lokacji, lokalizacji i serwera, aby umożliwić operacje odczytu lub zapisu.
OpenWebConfiguration(String, String, String, String, IntPtr)	Otwiera plik konfiguracji aplikacji internetowej jako Configuration obiekt przy użyciu określonej ścieżki wirtualnej, nazwy lokacji, lokalizacji, serwera i kontekstu zabezpieczeń, aby umożliwić operacje odczytu lub zapisu.
OpenWebConfiguration(String, String, String, String, String, String)	Otwiera plik konfiguracji aplikacji internetowej jako Configuration obiekt przy użyciu określonej ścieżki wirtualnej, nazwy lokacji, lokalizacji, serwera i kontekstu zabezpieczeń, aby umożliwić operacje odczytu lub zapisu.

Dotyczy