WebConfigurationManager Klas

Definitie

Naamruimte:: System.Web.Configuration

Assembly:: System.Web.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Biedt toegang tot configuratiebestanden wanneer deze van toepassing zijn op webtoepassingen.

public ref class WebConfigurationManager abstract sealed

public static class WebConfigurationManager

type WebConfigurationManager = class

Public Class WebConfigurationManager

Overname: Object
WebConfigurationManager

Voorbeelden

In het volgende voorbeeld ziet u hoe u toegang krijgen tot configuratiegegevens met de

GetSection methode.


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

Opmerkingen

Met de WebConfigurationManager klasse hebt u toegang tot computer- en toepassingsgegevens.

Het gebruik WebConfigurationManager is de voorkeurswijze om te werken met configuratiebestanden met betrekking tot webtoepassingen. Gebruik de ConfigurationManager klasse voor clienttoepassingen.

Uw toepassing kan de System.Configuration typen uitbreiden of deze rechtstreeks gebruiken om configuratiegegevens te verwerken, zoals wordt uitgelegd in de volgende lijst:

Handling configuration. Als u configuratiegegevens wilt verwerken met behulp van de standaardtypen, gebruikt u een van de volgende methoden:
- Accessing a section. Als u toegang wilt krijgen tot configuratiegegevens voor uw toepassing, moet u een van de GetSection methoden WebConfigurationManagervan . Voor <appSettings> en <connectionStrings>, gebruikt u de AppSettings en ConnectionStrings eigenschappen. Deze methoden voeren alleen-lezenbewerkingen uit, gebruiken één exemplaar in de cache van de configuratie en zijn multithread-bewust.
- Accessing configuration files. Uw toepassing kan configuratie-instellingen lezen en schrijven op elk niveau, voor zichzelf of voor andere toepassingen of computers, lokaal of op afstand. U gebruikt een van de open methoden van WebConfigurationManager. Deze methoden retourneren een Configuration object, dat op zijn beurt de vereiste methoden en eigenschappen biedt voor het verwerken van de onderliggende configuratiebestanden. Deze methoden voeren lees- of schrijfbewerkingen uit en maken de configuratiegegevens opnieuw telkens wanneer een bestand wordt geopend.
- Advanced configuration. Geavanceerdere configuratieafhandeling wordt geleverd door de typenSectionInformation, PropertyInformation, PropertyInformationCollection, , ElementInformation, ContextInformation, en ConfigurationSectionGroupCollection ConfigurationSectionGroup.
Extending configuration standard types. U kunt ook uw aangepaste configuratie-elementen opgeven door de standaardconfiguratietypen zoals ConfigurationElement, ConfigurationElementCollectionen ConfigurationProperty ConfigurationSection met behulp van een programmatisch of een toegeschreven model uit te breiden. Raadpleeg de ConfigurationSection klasse voor een voorbeeld van het programmatisch uitbreiden van een standaardconfiguratietype. Raadpleeg de ConfigurationElement klasse voor een voorbeeld van het uitbreiden van een standaardconfiguratietype met behulp van het toegewezen model.

Notities voor overnemers

De Configuration klasse biedt programmatische toegang voor het bewerken van configuratiebestanden. U gebruikt een van de open methoden van WebConfigurationManager. Deze methoden retourneren een Configuration object, dat op zijn beurt de vereiste methoden en eigenschappen biedt voor het verwerken van de onderliggende configuratiebestanden. U kunt deze bestanden als volgt openen voor lezen of schrijven:

U gebruikt GetSection(String) of GetSectionGroup(String) leest configuratiegegevens. Houd er rekening mee dat de gebruiker of het proces dat wordt gelezen, de volgende machtigingen moet hebben:

Leesmachtiging voor het configuratiebestand op het huidige niveau van de configuratiehiërarchie.
Leesmachtigingen voor alle bovenliggende configuratiebestanden.

Als uw toepassing alleen-lezentoegang tot een eigen configuratie nodig heeft, wordt u aangeraden de GetSection methoden te gebruiken. Deze methoden bieden toegang tot de configuratiewaarden in de cache voor de huidige toepassing, die betere prestaties heeft dan de Configuration klasse.

Opmerking: Als u een statische GetSection methode gebruikt die een path parameter gebruikt, moet de padparameter verwijzen naar de toepassing waarin de code wordt uitgevoerd. Anders wordt de parameter genegeerd en wordt configuratiegegevens voor de huidige toepassing geretourneerd.

U gebruikt een van de Save methoden om configuratiegegevens te schrijven. Houd er rekening mee dat de gebruiker of het proces die schrijfbewerkingen schrijft, over de volgende machtigingen moet beschikken:

Schrijfmachtiging voor het configuratiebestand en de map op het huidige niveau van de configuratiehiërarchie.
Leesmachtigingen voor alle configuratiebestanden.

Eigenschappen

Name	Description
AppSettings	Hiermee haalt u de toepassingsinstellingen van de website op.
ConnectionStrings	Hiermee haalt u de verbindingsreeksen van de website op.

Methoden

Name	Description
GetSection(String, String)	Haalt de opgegeven configuratiesectie op uit het configuratiebestand van de webtoepassing op de opgegeven locatie.
GetSection(String)	Haalt de opgegeven configuratiesectie op uit het configuratiebestand van de huidige webtoepassing.
GetWebApplicationSection(String)	Haalt de opgegeven configuratiesectie op uit het configuratiebestand van de huidige webtoepassing.
OpenMachineConfiguration()	Hiermee opent u het computerconfiguratiebestand op de huidige computer als een Configuration object om lees- of schrijfbewerkingen toe te staan.
OpenMachineConfiguration(String, String, IntPtr)	Hiermee opent u het opgegeven computerconfiguratiebestand op de opgegeven server als een Configuration object, met behulp van de opgegeven beveiligingscontext om lees- of schrijfbewerkingen toe te staan.
OpenMachineConfiguration(String, String, String, String)	Hiermee opent u het opgegeven computerconfiguratiebestand op de opgegeven server als een Configuration object, met behulp van de opgegeven beveiligingscontext om lees- of schrijfbewerkingen toe te staan.
OpenMachineConfiguration(String, String)	Hiermee opent u het opgegeven computerconfiguratiebestand op de opgegeven server als een Configuration object om lees- of schrijfbewerkingen toe te staan.
OpenMachineConfiguration(String)	Hiermee opent u het computerconfiguratiebestand op de huidige computer als een Configuration object om lees- of schrijfbewerkingen toe te staan.
OpenMappedMachineConfiguration(ConfigurationFileMap, String)	Hiermee opent u het computerconfiguratiebestand als een Configuration object met behulp van de opgegeven bestandstoewijzing en -locatie om lees- of schrijfbewerkingen toe te staan.
OpenMappedMachineConfiguration(ConfigurationFileMap)	Hiermee opent u het computerconfiguratiebestand als een Configuration object met behulp van de opgegeven bestandstoewijzing om lees- of schrijfbewerkingen toe te staan.
OpenMappedWebConfiguration(WebConfigurationFileMap, String, String, String)	Hiermee opent u het opgegeven configuratiebestand voor webtoepassingen als een Configuration object met behulp van de opgegeven bestandstoewijzing, het virtuele pad, de sitenaam en de locatie om lees- of schrijfbewerkingen toe te staan.
OpenMappedWebConfiguration(WebConfigurationFileMap, String, String)	Hiermee opent u het opgegeven configuratiebestand voor webtoepassingen als een Configuration object met behulp van de opgegeven bestandstoewijzing, het virtuele pad en de sitenaam om lees- of schrijfbewerkingen toe te staan.
OpenMappedWebConfiguration(WebConfigurationFileMap, String)	Hiermee opent u het opgegeven configuratiebestand voor webtoepassingen als een Configuration object met behulp van de opgegeven bestandstoewijzing en het virtuele pad om lees- of schrijfbewerkingen toe te staan.
OpenWebConfiguration(String, String, String, String, IntPtr)	Hiermee opent u het configuratiebestand van de webtoepassing als een Configuration object met behulp van het opgegeven virtuele pad, de sitenaam, de locatie, de server en de beveiligingscontext om lees- of schrijfbewerkingen toe te staan.
OpenWebConfiguration(String, String, String, String, String, String)	Hiermee opent u het configuratiebestand van de webtoepassing als een Configuration object met behulp van het opgegeven virtuele pad, de sitenaam, de locatie, de server en de beveiligingscontext om lees- of schrijfbewerkingen toe te staan.
OpenWebConfiguration(String, String, String, String)	Hiermee opent u het configuratiebestand van de webtoepassing als een Configuration object met behulp van het opgegeven virtuele pad, de sitenaam, de locatie en de server om lees- of schrijfbewerkingen toe te staan.
OpenWebConfiguration(String, String, String)	Hiermee opent u het configuratiebestand van de webtoepassing als een Configuration object met behulp van het opgegeven virtuele pad, de sitenaam en de locatie om lees- of schrijfbewerkingen toe te staan.
OpenWebConfiguration(String, String)	Hiermee opent u het configuratiebestand van de webtoepassing als een Configuration object met behulp van het opgegeven virtuele pad en de sitenaam om lees- of schrijfbewerkingen toe te staan.
OpenWebConfiguration(String)	Hiermee opent u het configuratiebestand van de webtoepassing als een Configuration object met behulp van het opgegeven virtuele pad om lees- of schrijfbewerkingen toe te staan.

Van toepassing op

Zie ook

Feedback

Is deze pagina nuttig?