WebConfigurationManager Osztály

Definíció

Névtér:

System.Web.Configuration

Szerelvény:

System.Web.dll

Hozzáférést biztosít a konfigurációs fájlokhoz, ahogy azok a webalkalmazásokra vonatkoznak.

public ref class WebConfigurationManager abstract sealed

public static class WebConfigurationManager

type WebConfigurationManager = class

Public Class WebConfigurationManager

Öröklődés

Object

WebConfigurationManager

Példák

Az alábbi példa bemutatja, hogyan férhet hozzá a konfigurációs adatokhoz a

GetSection módszer.

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

Megjegyzések

Az WebConfigurationManager osztály lehetővé teszi a számítógép- és alkalmazásadatok elérését.

A webalkalmazásokhoz kapcsolódó konfigurációs fájlok használatának elsődleges módja a használat WebConfigurationManager . Ügyfélalkalmazások esetén használja az osztályt ConfigurationManager .

Az alkalmazás kiterjesztheti a System.Configuration típusokat, vagy közvetlenül használhatja őket a konfigurációs információk kezelésére az alábbi listában leírtak szerint:

• Handling configuration. A konfigurációs adatok standard típusok használatával történő kezeléséhez az alábbi módszerek egyikét kell használnia:

  • Accessing a section. Az alkalmazás konfigurációs adatainak eléréséhez a megadott módszerek GetSectionegyikét WebConfigurationManager kell használnia. Az <appSettings> és<connectionStrings>, a tulajdonságokat és AppSettings a ConnectionStrings tulajdonságokat használja. Ezek a metódusok írásvédett műveleteket hajtanak végre, a konfiguráció egyetlen gyorsítótárazott példányát használják, és többszálúak.

  • Accessing configuration files. Az alkalmazás képes a konfigurációs beállítások olvasására és írására bármilyen szinten, önmagában vagy más alkalmazásokban vagy számítógépeken, helyileg vagy távolról. A > által megadott módszerek egyikét használja. Ezek a metódusok egy objektumot Configuration ad vissza, amely biztosítja az alapul szolgáló konfigurációs fájlok kezeléséhez szükséges módszereket és tulajdonságokat. Ezek a metódusok olvasási vagy írási műveleteket hajtanak végre, és minden fájl megnyitásakor újra létrehozza a konfigurációs adatokat.

  • Advanced configuration. A speciálisabb konfigurációkezelést a típusok SectionInformation, PropertyInformation, , PropertyInformationCollection, ElementInformationContextInformation, ConfigurationSectionGroupés ConfigurationSectionGroupCollection.

• Extending configuration standard types. Az egyéni konfigurációs elemeket úgy is megadhatja, hogy kiterjeszti az olyan standard konfigurációs típusokat, mint ConfigurationElementpéldául a , ConfigurationElementCollection, ConfigurationPropertyés ConfigurationSection egy programozott vagy egy attribútumos modell használatával. Tekintse meg az ConfigurationSection osztályt egy példa arra, hogyan terjeszthet ki programozott módon egy standard konfigurációs típust. Tekintse meg az ConfigurationElement osztályt egy példa arra, hogyan terjeszthet ki egy standard konfigurációs típust az attribútumos modell használatával.

Megjegyzések az öröklőkhöz

Az Configuration osztály programozott hozzáférést biztosít a konfigurációs fájlok szerkesztéséhez. A megadott nyílt metódusok egyikét WebConfigurationManagerhasználja. Ezek a metódusok egy objektumot Configuration ad vissza, amely biztosítja az alapul szolgáló konfigurációs fájlok kezeléséhez szükséges módszereket és tulajdonságokat. Ezeket a fájlokat az alábbiak szerint érheti el olvasáshoz vagy íráshoz:

A konfigurációs információkat használja GetSection(String) vagy GetSectionGroup(String) olvassa el. Vegye figyelembe, hogy az olvasó felhasználónak vagy folyamatnak a következő engedélyekkel kell rendelkeznie:

• Olvasási engedély a konfigurációs fájlon az aktuális konfigurációs hierarchia szintjén.

• Olvasási engedélyek az összes szülőkonfigurációs fájlon.

Ha az alkalmazásnak írásvédett hozzáférésre van szüksége a saját konfigurációjához, javasoljuk, hogy használja a GetSection metódusokat. Ezek a metódusok hozzáférést biztosítanak az aktuális alkalmazás gyorsítótárazott konfigurációs értékeihez, amelyek jobb teljesítményt nyújtanak, mint az Configuration osztály.

Megjegyzés: Ha egy paramétert használó GetSection statikus path metódust használ, az elérési út paraméterének arra az alkalmazásra kell hivatkoznia, amelyben a kód fut; ellenkező esetben a paraméter figyelmen kívül lesz hagyva, és a rendszer visszaadja a jelenleg futó alkalmazás konfigurációs adatait.

A konfigurációs adatok írásához használja az Save egyik metódust. Vegye figyelembe, hogy az írást végző felhasználónak vagy folyamatnak a következő engedélyekkel kell rendelkeznie:

• Írási engedély a konfigurációs fájlra és a könyvtárra az aktuális konfigurációs hierarchia szintjén.

• Olvasási engedélyek az összes konfigurációs fájlon.

Tulajdonságok

Name	Description
AppSettings	Lekéri a webhely alkalmazásbeállítását.
ConnectionStrings	Lekéri a webhely kapcsolati sztringjét.

Metódusok

Name	Description
GetSection(String, String)	Lekéri a megadott konfigurációs szakaszt a webalkalmazás konfigurációs fájljából a megadott helyen.
GetSection(String)	Lekéri a megadott konfigurációs szakaszt az aktuális webalkalmazás konfigurációs fájljából.
GetWebApplicationSection(String)	Lekéri a megadott konfigurációs szakaszt az aktuális webalkalmazás konfigurációs fájljából.
OpenMachineConfiguration()	Megnyitja az aktuális számítógépen lévő gépkonfigurációs fájlt objektumként Configuration az olvasási vagy írási műveletek engedélyezéséhez.
OpenMachineConfiguration(String, String, IntPtr)	A megadott gépkonfigurációs fájlt objektumként Configuration nyitja meg a megadott kiszolgálón a megadott biztonsági környezettel olvasási vagy írási műveletek engedélyezéséhez.
OpenMachineConfiguration(String, String, String, String)	A megadott gépkonfigurációs fájlt objektumként Configuration nyitja meg a megadott kiszolgálón a megadott biztonsági környezettel olvasási vagy írási műveletek engedélyezéséhez.
OpenMachineConfiguration(String, String)	Megnyitja a megadott gépkonfigurációs fájlt a megadott kiszolgálón objektumként Configuration az olvasási vagy írási műveletek engedélyezéséhez.
OpenMachineConfiguration(String)	Megnyitja az aktuális számítógépen lévő gépkonfigurációs fájlt objektumként Configuration az olvasási vagy írási műveletek engedélyezéséhez.
OpenMappedMachineConfiguration(ConfigurationFileMap, String)	Megnyitja a gépkonfigurációs fájlt objektumként Configuration a megadott fájlleképezés és hely használatával az olvasási és írási műveletek engedélyezéséhez.
OpenMappedMachineConfiguration(ConfigurationFileMap)	Megnyitja a gép konfigurációs fájlját objektumként Configuration , a megadott fájlleképezés használatával olvasási vagy írási műveleteket engedélyezve.
OpenMappedWebConfiguration(WebConfigurationFileMap, String, String, String)	A megadott webalkalmazás konfigurációs fájlját objektumként Configuration nyitja meg a megadott fájlleképezés, virtuális elérési út, helynév és hely használatával az olvasási vagy írási műveletek engedélyezéséhez.
OpenMappedWebConfiguration(WebConfigurationFileMap, String, String)	Megnyitja a megadott webalkalmazás-konfigurációs fájlt objektumként Configuration a megadott fájlleképezés, virtuális elérési út és helynév használatával az olvasási vagy írási műveletek engedélyezéséhez.
OpenMappedWebConfiguration(WebConfigurationFileMap, String)	Megnyitja a megadott webalkalmazás-konfigurációs fájlt objektumként Configuration a megadott fájlleképezés és virtuális elérési út használatával az olvasási vagy írási műveletek engedélyezéséhez.
OpenWebConfiguration(String, String, String, String, IntPtr)	Megnyitja a webalkalmazás konfigurációs fájlját objektumként Configuration a megadott virtuális elérési út, helynév, hely, kiszolgáló és biztonsági környezet használatával az olvasási vagy írási műveletek engedélyezéséhez.
OpenWebConfiguration(String, String, String, String, String, String)	Megnyitja a webalkalmazás konfigurációs fájlját objektumként Configuration a megadott virtuális elérési út, helynév, hely, kiszolgáló és biztonsági környezet használatával az olvasási vagy írási műveletek engedélyezéséhez.
OpenWebConfiguration(String, String, String, String)	Megnyitja a webalkalmazás konfigurációs fájlját objektumként Configuration a megadott virtuális elérési út, helynév, hely és kiszolgáló használatával az olvasási és írási műveletek engedélyezéséhez.
OpenWebConfiguration(String, String, String)	Megnyitja a webalkalmazás konfigurációs fájlját objektumként Configuration a megadott virtuális elérési út, helynév és hely használatával az olvasási és írási műveletek engedélyezéséhez.
OpenWebConfiguration(String, String)	Megnyitja a webalkalmazás konfigurációs fájlját objektumként Configuration a megadott virtuális elérési út és helynév használatával az olvasási és írási műveletek engedélyezéséhez.
OpenWebConfiguration(String)	Megnyitja a webalkalmazás konfigurációs fájlját objektumként Configuration a megadott virtuális elérési út használatával olvasási vagy írási műveletek engedélyezéséhez.

Lásd még

• Configuration
• ConfigurationManager
• ASP.NET konfiguráció áttekintése