WebConfigurationManager Sınıf

Tanım

Ad Alanı:

System.Web.Configuration

Bütünleştirilmiş Kod:

System.Web.dll

Web uygulamaları için geçerli olan yapılandırma dosyalarına erişim sağlar.

public ref class WebConfigurationManager abstract sealed

public static class WebConfigurationManager

type WebConfigurationManager = class

Public Class WebConfigurationManager

Devralma

Object

WebConfigurationManager

Örnekler

Aşağıdaki örnekte yapılandırma bilgilerine

GetSection Yöntem.

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

Açıklamalar

sınıfı, WebConfigurationManager bilgisayar ve uygulama bilgilerine erişmenizi sağlar.

Web WebConfigurationManager uygulamalarıyla ilgili yapılandırma dosyalarıyla çalışmak için tercih edilen yöntem kullanmaktır. İstemci uygulamaları için sınıfını ConfigurationManager kullanın.

Uygulamanız, aşağıdaki listede açıklandığı gibi türleri genişletebilir System.Configuration veya yapılandırma bilgilerini işlemek için doğrudan kullanabilir:

• Handling configuration. Standart türleri kullanarak yapılandırma bilgilerini işlemek için aşağıdaki yaklaşımlardan birini kullanırsınız:

  • Accessing a section. Uygulamanızın yapılandırma bilgilerine erişmek için tarafından WebConfigurationManagersağlanan yöntemlerden birini GetSection kullanmanız gerekir. ve için <appSettings> ve <connectionStrings>ConnectionStrings özelliklerini kullanırsınızAppSettings. Bu yöntemler salt okunur işlemler gerçekleştirir, yapılandırmanın önbelleğe alınmış tek bir örneğini kullanır ve çok iş parçacığına duyarlıdır.

  • Accessing configuration files. Uygulamanız, yapılandırma ayarlarını kendisi veya diğer uygulamalar ya da bilgisayarlar için yerel olarak veya uzaktan herhangi bir düzeyde okuyabilir ve yazabilir. tarafından WebConfigurationManagersağlanan yöntemlerden birini open kullanırsınız. Bu yöntemler, temel yapılandırma dosyalarını işlemek için gerekli yöntemleri ve özellikleri sağlayan bir Configuration nesnesi döndürür. Bu yöntemler okuma veya yazma işlemleri gerçekleştirir ve bir dosya her açıldığında yapılandırma verilerini yeniden oluşturur.

  • Advanced configuration. Daha gelişmiş yapılandırma işleme , , , PropertyInformationCollectionPropertyInformation, ElementInformationContextInformation, ConfigurationSectionGroupve ConfigurationSectionGroupCollectiontürleri SectionInformationtarafından sağlanır.

• Extending configuration standard types. Ayrıca, , ConfigurationElementCollection, ConfigurationPropertyve ConfigurationSection gibi ConfigurationElementstandart yapılandırma türlerini program aracılığıyla veya öznitelikli bir model kullanarak genişleterek özel yapılandırma öğelerinizi sağlayabilirsiniz. ConfigurationSection Standart yapılandırma türünü program aracılığıyla genişletme örneği için sınıfına bakın. Öznitelikli ConfigurationElement modeli kullanarak standart yapılandırma türünü genişletme örneği için sınıfına bakın.

Devralanlara Notlar

sınıfı, Configuration yapılandırma dosyalarını düzenlemek için programlı erişime izin verir. tarafından WebConfigurationManagersağlanan açık yöntemlerden birini kullanırsınız. Bu yöntemler, temel yapılandırma dosyalarını işlemek için gerekli yöntemleri ve özellikleri sağlayan bir Configuration nesnesi döndürür. Bu dosyalara okumak veya yazmak için aşağıdaki gibi erişebilirsiniz:

Yapılandırma bilgilerini okumak için veya GetSectionGroup(String) kullanırsınızGetSection(String). Okuyan kullanıcının veya işlemin aşağıdaki izinlere sahip olması gerektiğini unutmayın:

• Geçerli yapılandırma hiyerarşisi düzeyinde yapılandırma dosyasında okuma izni.

• Tüm üst yapılandırma dosyalarındaki okuma izinleri.

Uygulamanızın kendi yapılandırmasına salt okunur erişime ihtiyacı varsa, yöntemleri kullanmanız GetSection önerilir. Bu yöntemler, geçerli uygulama için önbelleğe alınmış yapılandırma değerlerine erişim sağlar ve bu da sınıftan daha iyi performansa Configuration sahiptir.

Not: Parametre alan statik GetSection bir path yöntem kullanırsanız, yol parametresi kodun çalıştığı uygulamaya başvurmalıdır; aksi takdirde parametre yoksayılır ve çalışmakta olan uygulamanın yapılandırma bilgileri döndürülür.

Yapılandırma bilgilerini yazmak için yöntemlerden birini Save kullanırsınız. Yazan kullanıcının veya işlemin aşağıdaki izinlere sahip olması gerektiğini unutmayın:

• Geçerli yapılandırma hiyerarşisi düzeyinde yapılandırma dosyası ve dizini üzerinde yazma izni.

• Tüm yapılandırma dosyalarındaki okuma izinleri.

Özellikler

AppSettings	Web sitesinin uygulama ayarlarını alır.
ConnectionStrings	Web sitesinin bağlantı dizelerini alır.

Yöntemler

GetSection(String)	Belirtilen yapılandırma bölümünü geçerli Web uygulamasının yapılandırma dosyasından alır.
GetSection(String, String)	Belirtilen konumdaki Web uygulamasının yapılandırma dosyasından belirtilen yapılandırma bölümünü alır.
GetWebApplicationSection(String)	Belirtilen yapılandırma bölümünü geçerli Web uygulamasının yapılandırma dosyasından alır.
OpenMachineConfiguration()	Okuma veya yazma işlemlerine izin vermek için geçerli bilgisayardaki makine yapılandırma dosyasını bir Configuration nesne olarak açar.
OpenMachineConfiguration(String)	Okuma veya yazma işlemlerine izin vermek için geçerli bilgisayardaki makine yapılandırma dosyasını bir Configuration nesne olarak açar.
OpenMachineConfiguration(String, String)	Belirtilen sunucudaki belirtilen makine yapılandırma dosyasını okuma veya yazma işlemlerine izin verecek bir Configuration nesne olarak açar.
OpenMachineConfiguration(String, String, IntPtr)	Belirtilen sunucudaki belirtilen makine yapılandırma dosyasını nesne Configuration olarak açar ve okuma veya yazma işlemlerine izin vermek için belirtilen güvenlik bağlamını kullanır.
OpenMachineConfiguration(String, String, String, String)	Belirtilen sunucudaki belirtilen makine yapılandırma dosyasını nesne Configuration olarak açar ve okuma veya yazma işlemlerine izin vermek için belirtilen güvenlik bağlamını kullanır.
OpenMappedMachineConfiguration(ConfigurationFileMap)	Makine yapılandırma dosyasını, okuma veya yazma işlemlerine izin vermek için belirtilen dosya eşlemesini kullanarak bir Configuration nesne olarak açar.
OpenMappedMachineConfiguration(ConfigurationFileMap, String)	Makine yapılandırma dosyasını, okuma veya yazma işlemlerine izin vermek için belirtilen dosya eşlemesini ve konumunu kullanarak bir Configuration nesne olarak açar.
OpenMappedWebConfiguration(WebConfigurationFileMap, String)	Belirtilen Web uygulaması yapılandırma dosyasını, okuma veya yazma işlemlerine izin vermek için belirtilen dosya eşlemesini ve sanal yolu kullanarak bir Configuration nesne olarak açar.
OpenMappedWebConfiguration(WebConfigurationFileMap, String, String)	Belirtilen Web uygulaması yapılandırma dosyasını, okuma veya yazma işlemlerine izin vermek için belirtilen dosya eşlemesini, sanal yolu ve site adını kullanarak bir Configuration nesne olarak açar.
OpenMappedWebConfiguration(WebConfigurationFileMap, String, String, String)	Belirtilen Web uygulaması yapılandırma dosyasını, okuma veya yazma işlemlerine izin vermek için belirtilen dosya eşlemesini, sanal yolu, site adını ve konumu kullanarak bir Configuration nesne olarak açar.
OpenWebConfiguration(String)	Web uygulaması yapılandırma dosyasını, okuma veya yazma işlemlerine izin vermek için belirtilen sanal yolu kullanan bir Configuration nesne olarak açar.
OpenWebConfiguration(String, String)	Web uygulaması yapılandırma dosyasını, okuma veya yazma işlemlerine izin vermek için belirtilen sanal yolu ve site adını kullanarak bir Configuration nesne olarak açar.
OpenWebConfiguration(String, String, String)	Web uygulaması yapılandırma dosyasını, okuma veya yazma işlemlerine izin vermek için belirtilen sanal yolu, site adını ve konumu kullanarak bir Configuration nesne olarak açar.
OpenWebConfiguration(String, String, String, String)	Web uygulaması yapılandırma dosyasını, okuma veya yazma işlemlerine izin vermek için belirtilen sanal yolu, site adını, konumu ve sunucuyu kullanarak bir Configuration nesne olarak açar.
OpenWebConfiguration(String, String, String, String, IntPtr)	Web uygulaması yapılandırma dosyasını, okuma veya yazma işlemlerine izin vermek için belirtilen sanal yolu, site adını, konumu, sunucuyu ve güvenlik bağlamını kullanarak bir Configuration nesne olarak açar.
OpenWebConfiguration(String, String, String, String, String, String)	Web uygulaması yapılandırma dosyasını, okuma veya yazma işlemlerine izin vermek için belirtilen sanal yolu, site adını, konumu, sunucuyu ve güvenlik bağlamını kullanarak bir Configuration nesne olarak açar.

Ayrıca bkz.

• Configuration
• ConfigurationManager
• ASP.NET Yapılandırmasına Genel Bakış