WebConfigurationManager Třída

Reference

Definice

Obor názvů:: System.Web.Configuration

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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 ke konfiguračním informacím 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žívání WebConfigurationManager je upřednostňovaný způsob práce s konfiguračními soubory souvisejícími s webovými aplikacemi. Pro klientské aplikace použijte ConfigurationManager třídu .

Aplikace může rozšířit System.Configuration typy nebo je použít přímo ke zpracování konfiguračních informací, 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ů:
- Accessing a section. Pokud chcete získat přístup ke konfiguračním informacím pro vaši aplikaci, musíte použít jednu z GetSection metod poskytovaných nástrojem WebConfigurationManager. Pro <appSettings> a <connectionStrings>použijte AppSettings vlastnosti a ConnectionStrings . Tyto metody provádějí operace jen pro čtení, používají jednu instanci konfigurace uložené v mezipaměti a využívají více vláken.
- Accessing configuration files. Vaše aplikace může číst a zapisovat nastavení konfigurace na libovolné úrovni, pro sebe nebo pro jiné aplikace nebo počítače, místně nebo vzdáleně. Použijete jednu z metod poskytovaných open nástrojem WebConfigurationManager. Tyto metody vrátí Configuration objekt, který následně poskytuje požadované metody a vlastnosti pro zpracování podkladových konfiguračních souborů. Tyto metody provádějí operace čtení nebo zápisu a znovu vytvoří konfigurační data při každém otevření souboru.
- Advanced configuration. Pokročilejší zpracování konfigurace poskytují typy SectionInformation, , PropertyInformationCollection PropertyInformation, ElementInformation, ContextInformation, , ConfigurationSectionGroupa ConfigurationSectionGroupCollection.
Extending configuration standard types. Můžete také poskytnout vlastní konfigurační prvky rozšířením standardních typů konfigurace, jako ConfigurationElementjsou , ConfigurationElementCollection ConfigurationPropertya ConfigurationSection pomocí programového nebo atributového modelu. Podívejte se na ConfigurationSection třídu, kde najdete příklad, jak programově rozšířit standardní typ konfigurace. 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 nástrojem WebConfigurationManager. Tyto metody vrátí Configuration objekt, který následně 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:

Ke čtení informací o konfiguraci použijete GetSection(String) nebo GetSectionGroup(String) . 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í všech nadřazených konfiguračních souborů

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

Poznámka: Pokud použijete statickou GetSection metodu path , která přebírá parametr, musí parametr cesty odkazovat na aplikaci, ve které je kód spuštěný. V opačném případě 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 těchto 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 do 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

AppSettings	Získá nastavení aplikace webu.
ConnectionStrings	Získá připojovací řetězce webu.

Metody

GetSection(String)	Načte zadaný oddíl konfigurace z konfiguračního souboru aktuální webové aplikace.
GetSection(String, String)	Načte zadaný oddíl konfigurace z konfiguračního souboru webové aplikace v zadaném umístění.
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 pro povolení operací čtení nebo zápisu.
OpenMachineConfiguration(String)	Otevře konfigurační soubor počítače v aktuálním počítači jako Configuration objekt pro povolení operací čtení nebo zápisu.
OpenMachineConfiguration(String, String)	Otevře zadaný soubor konfigurace počítače na zadaném serveru jako Configuration objekt pro povolení operací čtení nebo zápisu.
OpenMachineConfiguration(String, String, IntPtr)	Otevře zadaný soubor konfigurace počítače na zadaném Configuration serveru jako objekt s použitím zadaného kontextu zabezpečení pro povolení operací čtení nebo zápisu.
OpenMachineConfiguration(String, String, String, String)	Otevře zadaný soubor konfigurace počítače na zadaném Configuration serveru jako objekt s použitím zadaného kontextu zabezpečení pro povolení operací čtení nebo zápisu.
OpenMappedMachineConfiguration(ConfigurationFileMap)	Otevře soubor konfigurace počítače jako Configuration objekt s použitím zadaného mapování souborů, které umožní operace čtení nebo zápisu.
OpenMappedMachineConfiguration(ConfigurationFileMap, String)	Otevře soubor konfigurace počítače jako Configuration objekt s použitím zadaného mapování souborů a umístění pro povolení operací čtení nebo zápisu.
OpenMappedWebConfiguration(WebConfigurationFileMap, String)	Otevře zadaný konfigurační soubor webové aplikace jako Configuration objekt s použitím zadaného mapování souborů a virtuální cesty pro povolení operací čtení nebo zápisu.
OpenMappedWebConfiguration(WebConfigurationFileMap, String, String)	Otevře zadaný konfigurační soubor webové aplikace jako Configuration objekt s použitím zadaného mapování souborů, virtuální cesty a názvu webu pro povolení operací čtení nebo zápisu.
OpenMappedWebConfiguration(WebConfigurationFileMap, String, String, String)	Otevře zadaný konfigurační soubor webové aplikace jako Configuration objekt s použitím zadaného mapování souborů, virtuální cesty, názvu lokality a umístění pro povolení operací čtení nebo zápisu.
OpenWebConfiguration(String)	Otevře konfigurační soubor webové aplikace jako objekt používající zadanou Configuration virtuální cestu pro povolení operací čtení nebo zápisu.
OpenWebConfiguration(String, String)	Otevře konfigurační soubor webové aplikace jako objekt používající zadanou Configuration virtuální cestu a název lokality, aby bylo možné operace čtení nebo zápisu.
OpenWebConfiguration(String, String, String)	Otevře konfigurační soubor webové aplikace jako objekt používající zadanou Configuration virtuální cestu, název webu a umístění pro povolení operací čtení nebo zápisu.
OpenWebConfiguration(String, String, String, String)	Otevře konfigurační soubor webové aplikace jako objekt používající zadanou Configuration virtuální cestu, název webu, umístění a server pro povolení operací čtení nebo zápisu.
OpenWebConfiguration(String, String, String, String, IntPtr)	Otevře konfigurační soubor webové aplikace jako Configuration objekt s použitím zadané virtuální cesty, názvu lokality, 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 s použitím zadané virtuální cesty, názvu lokality, umístění, serveru a kontextu zabezpečení, aby bylo možné operace čtení nebo zápisu.

Platí pro

Sdílet prostřednictvím