WebConfigurationManager Klass

Definition

public ref class WebConfigurationManager abstract sealed

public static class WebConfigurationManager

type WebConfigurationManager = class

Public Class WebConfigurationManager

Arv

Object

WebConfigurationManager

Exempel

I följande exempel visas hur du kommer åt konfigurationsinformation med

GetSection metod.

// 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

Kommentarer

Med WebConfigurationManager klassen kan du komma åt dator- och programinformation.

Att använda WebConfigurationManager är det bästa sättet att arbeta med konfigurationsfiler relaterade till webbprogram. Använd klassen för ConfigurationManager klientprogram.

Ditt program kan utöka typerna System.Configuration eller använda dem direkt för att hantera konfigurationsinformation, enligt beskrivningen i följande lista:

• Handling configuration. Om du vill hantera konfigurationsinformation med hjälp av standardtyperna använder du någon av följande metoder:

  • Accessing a section. För att få åtkomst till konfigurationsinformation för ditt program måste du använda någon av metoderna GetSection som tillhandahålls av WebConfigurationManager. För <appSettings> och <connectionStrings>använder AppSettings du egenskaperna och ConnectionStrings . Dessa metoder utför skrivskyddade åtgärder, använder en enda cachelagrad instans av konfigurationen och är multitrådade.

  • Accessing configuration files. Ditt program kan läsa och skriva konfigurationsinställningar på valfri nivå, för sig själv eller för andra program eller datorer, lokalt eller via fjärranslutning. Du använder någon av metoderna open som tillhandahålls av WebConfigurationManager. Dessa metoder returnerar ett Configuration objekt som i sin tur tillhandahåller de metoder och egenskaper som krävs för att hantera de underliggande konfigurationsfilerna. Dessa metoder utför läs- eller skrivåtgärder och återskapar konfigurationsdata varje gång en fil öppnas.

  • Advanced configuration. Mer avancerad konfigurationshantering tillhandahålls av typerna SectionInformation, PropertyInformation, PropertyInformationCollection, ElementInformation, ContextInformation, ConfigurationSectionGroupoch ConfigurationSectionGroupCollection.

• Extending configuration standard types. Du kan också ange dina anpassade konfigurationselement genom att utöka standardkonfigurationstyperna, till exempel ConfigurationElement, ConfigurationElementCollection, ConfigurationPropertyoch ConfigurationSection med hjälp av en programmatisk eller en tilldelad modell. ConfigurationSection Se klassen för ett exempel på hur du utökar en standardkonfigurationstyp programmatiskt. ConfigurationElement Se klassen för ett exempel på hur du utökar en standardkonfigurationstyp med hjälp av den tilldelade modellen.

Anteckningar till arvingar

Klassen Configuration tillåter programmatisk åtkomst för redigering av konfigurationsfiler. Du använder någon av de öppna metoderna som tillhandahålls av WebConfigurationManager. Dessa metoder returnerar ett Configuration objekt som i sin tur tillhandahåller de metoder och egenskaper som krävs för att hantera de underliggande konfigurationsfilerna. Du kan komma åt dessa filer för att läsa eller skriva på följande sätt:

Du använder GetSection(String) eller GetSectionGroup(String) läser konfigurationsinformation. Observera att användaren eller processen som läser måste ha följande behörigheter:

• Läsbehörighet för konfigurationsfilen på den aktuella konfigurationshierarkinivån.

• Läsbehörigheter för alla överordnade konfigurationsfiler.

Om programmet behöver skrivskyddad åtkomst till sin egen konfiguration rekommenderar vi att du använder GetSection metoderna. De här metoderna ger åtkomst till de cachelagrade konfigurationsvärdena för det aktuella programmet, som har bättre prestanda än Configuration klassen.

Obs! Om du använder en statisk GetSection metod som tar en path parameter måste sökvägsparametern referera till programmet där koden körs. Annars ignoreras parametern och konfigurationsinformationen för det program som körs returneras.

Du använder någon av Save metoderna för att skriva konfigurationsinformation. Observera att användaren eller processen som skriver måste ha följande behörigheter:

• Skrivbehörighet för konfigurationsfilen och katalogen på den aktuella konfigurationshierarkinivån.

• Läsbehörigheter för alla konfigurationsfiler.

Se även

• Configuration
• ConfigurationManager
• ASP.NET konfigurationsöversikt