WebConfigurationManager Třída

Definice

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, , PropertyInformationCollectionPropertyInformation, 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 , ConfigurationElementCollectionConfigurationPropertya 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

Metody

Platí pro

Viz také

• Configuration
• ConfigurationManager
• přehled konfigurace ASP.NET