WebConfigurationManager Třída

Definice

Obor názvů:
System.Web.Configuration
Sestavení:
System.Web.dll

Poskytuje přístup ke konfiguračním souborům, které platí pro webové aplikace.

public ref class WebConfigurationManager abstract sealed
public static class WebConfigurationManager
type WebConfigurationManager = class
Public Class WebConfigurationManager
Dědičnost
Object
WebConfigurationManager

Příklady

Následující příklad ukazuje, jak získat přístup k informacím o konfiguraci pomocí

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

Poznámky

Třída WebConfigurationManager umožňuje přístup k informacím o počítači a aplikaci.

Použití WebConfigurationManager je upřednostňovaným způsobem práce s konfiguračními soubory souvisejícími s webovými aplikacemi. Pro klientské aplikace použijte ConfigurationManager třídu.

Vaše aplikace může rozšířit System.Configuration typy nebo je použít přímo ke zpracování informací o konfiguraci, jak je vysvětleno v následujícím seznamu:

  • Handling configuration. Pokud chcete zpracovávat informace o konfiguraci pomocí standardních typů, použijte jeden z následujících přístupů:

  • Extending configuration standard types. Vlastní konfigurační prvky můžete také poskytnout rozšířením standardních typů konfigurace, jako ConfigurationElementje , ConfigurationElementCollectionConfigurationProperty, a ConfigurationSection pomocí programového kódu nebo modelu s atributem. ConfigurationSection Příklad rozšíření standardního typu konfigurace prostřednictvím kódu programu najdete ve třídě. ConfigurationElement Příklad rozšíření standardního typu konfigurace pomocí atributového modelu najdete ve třídě.

Poznámky pro dědice

Třída Configuration umožňuje programový přístup pro úpravy konfiguračních souborů. Použijete jednu z otevřených metod poskytovaných .WebConfigurationManager Tyto metody vrátí Configuration objekt, který zase poskytuje požadované metody a vlastnosti pro zpracování podkladových konfiguračních souborů. K těmto souborům můžete přistupovat pro čtení nebo zápis následujícím způsobem:

Používáte GetSection(String) nebo GetSectionGroup(String) čtete informace o konfiguraci. Všimněte si, že uživatel nebo proces, který čte, musí mít následující oprávnění:

  • Oprávnění ke čtení konfiguračního souboru na aktuální úrovni hierarchie konfigurace

  • Oprávnění ke čtení u všech nadřazených konfiguračních souborů

Pokud vaše aplikace potřebuje přístup jen pro čtení k vlastní konfiguraci, doporučujeme použít metody GetSection . Tyto metody poskytují přístup k hodnotám konfigurace uložené v mezipaměti pro aktuální aplikaci, která má lepší výkon než Configuration třída.

Poznámka: Pokud používáte statickou GetSection metodu path , která přebírá parametr, musí parametr cesty odkazovat na aplikaci, ve které je kód spuštěn. Jinak se parametr ignoruje a vrátí se informace o konfiguraci aktuálně spuštěné aplikace.

K zápisu Save informací o konfiguraci použijete jednu z metod. Všimněte si, že uživatel nebo proces, který zapisuje, musí mít následující oprávnění:

  • Oprávnění k zápisu konfiguračního souboru a adresáře na aktuální úrovni hierarchie konfigurace

  • Oprávnění ke čtení všech konfiguračních souborů.

Vlastnosti

Name Description
AppSettings

Získá nastavení aplikace webu.
ConnectionStrings

Získá připojovací řetězce webu.

Metody

Name Description
GetSection(String, String)

Načte zadaný oddíl konfigurace z konfiguračního souboru webové aplikace v zadaném umístění.
GetSection(String)

Načte zadaný oddíl konfigurace z konfiguračního souboru aktuální webové aplikace.
GetWebApplicationSection(String)

Načte zadaný oddíl konfigurace z konfiguračního souboru aktuální webové aplikace.
OpenMachineConfiguration()

Otevře konfigurační soubor počítače v aktuálním počítači jako Configuration objekt, který povolí operace čtení nebo zápisu.
OpenMachineConfiguration(String, String, IntPtr)

Otevře zadaný konfigurační soubor počítače na zadaném Configuration serveru jako objekt pomocí zadaného kontextu zabezpečení pro povolení operací čtení nebo zápisu.
OpenMachineConfiguration(String, String, String, String)

Otevře zadaný konfigurační soubor počítače na zadaném Configuration serveru jako objekt pomocí zadaného kontextu zabezpečení pro povolení operací čtení nebo zápisu.
OpenMachineConfiguration(String, String)

Otevře zadaný konfigurační soubor počítače na zadaném Configuration serveru jako objekt, který povolí operace čtení nebo zápisu.
OpenMachineConfiguration(String)

Otevře konfigurační soubor počítače v aktuálním počítači jako Configuration objekt, který povolí operace čtení nebo zápisu.
OpenMappedMachineConfiguration(ConfigurationFileMap, String)

Otevře konfigurační soubor počítače jako Configuration objekt pomocí zadaného mapování souboru a umístění pro povolení operací čtení nebo zápisu.
OpenMappedMachineConfiguration(ConfigurationFileMap)

Otevře konfigurační soubor počítače jako Configuration objekt pomocí zadaného mapování souborů, které umožní operace čtení nebo zápisu.
OpenMappedWebConfiguration(WebConfigurationFileMap, String, String, String)

Otevře zadaný konfigurační soubor webové aplikace jako Configuration objekt pomocí zadaného mapování souborů, virtuální cesty, názvu webu a umístění pro povolení operací čtení nebo zápisu.
OpenMappedWebConfiguration(WebConfigurationFileMap, String, String)

Otevře zadaný konfigurační soubor webové aplikace jako Configuration objekt pomocí zadaného mapování souborů, virtuální cesty a názvu webu pro povolení operací čtení nebo zápisu.
OpenMappedWebConfiguration(WebConfigurationFileMap, String)

Otevře zadaný konfigurační soubor webové aplikace jako Configuration objekt pomocí zadaného mapování souborů a virtuální cesty pro povolení operací čtení nebo zápisu.
OpenWebConfiguration(String, String, String, String, IntPtr)

Otevře konfigurační soubor webové aplikace jako Configuration objekt pomocí zadané virtuální cesty, názvu webu, umístění, serveru a kontextu zabezpečení, aby bylo možné operace čtení nebo zápisu.
OpenWebConfiguration(String, String, String, String, String, String)

Otevře konfigurační soubor webové aplikace jako Configuration objekt pomocí zadané virtuální cesty, názvu webu, umístění, serveru a kontextu zabezpečení, aby bylo možné operace čtení nebo zápisu.
OpenWebConfiguration(String, String, String, String)

Otevře konfigurační soubor webové aplikace jako Configuration objekt pomocí zadané virtuální cesty, názvu webu, umístění a serveru, aby bylo možné operace čtení nebo zápisu povolit.
OpenWebConfiguration(String, String, String)

Otevře konfigurační soubor webové aplikace jako Configuration objekt pomocí zadané virtuální cesty, názvu webu a umístění pro povolení operací čtení nebo zápisu.
OpenWebConfiguration(String, String)

Otevře konfigurační soubor webové aplikace jako Configuration objekt pomocí zadané virtuální cesty a názvu webu pro povolení operací čtení nebo zápisu.
OpenWebConfiguration(String)

Otevře konfigurační soubor webové aplikace jako Configuration objekt pomocí zadané virtuální cesty pro povolení operací čtení nebo zápisu.

Platí pro

Viz také