WebConfigurationManager Sınıf

Tanım

Ad Alanı:

System.Web.Configuration

Bütünleştirilmiş Kod:

System.Web.dll

Web uygulamalarına uygulandıkça 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ışmanın tercih edilen yolu 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 GetSectionsağlanan yöntemlerden birini WebConfigurationManager kullanmanız gerekir. ve için <appSettings> ve <connectionStrings>AppSettings özelliklerini kullanırsınızConnectionStrings. 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 çoklu iş parçacığı kullanan yöntemlerdir.

  • Accessing configuration files. Uygulamanız, yapılandırma ayarlarını kendisi veya diğer uygulamalar veya bilgisayarlar için yerel veya uzaktan herhangi bir düzeyde okuyabilir ve yazabilir. opentarafından sağlanan WebConfigurationManager yöntemlerinden 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 nesne 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, , , SectionInformation, PropertyInformationPropertyInformationCollection, ElementInformation, ContextInformationve ConfigurationSectionGrouptürleri ConfigurationSectionGroupCollectiontarafından sağlanır.

• Extending configuration standard types. Ayrıca, , ConfigurationElement, ConfigurationElementCollectiongibi ConfigurationPropertystandart yapılandırma türlerini genişleterek ve ConfigurationSection program aracılığıyla veya öznitelikli bir model kullanarak özel yapılandırma öğelerinizi sağlayabilirsiniz. ConfigurationSection Standart yapılandırma türünün program aracılığıyla nasıl genişletılacağını gösteren bir örnek 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 nesne 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 GetSection(String) kullanırsınızGetSectionGroup(String). Okuyan kullanıcı 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 izinleri okuyun.

Uygulamanızın kendi yapılandırmasına salt okunur erişime ihtiyacı varsa, yöntemlerini 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ıfından daha iyi bir 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 izinleri okuyun.

Özellikler

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

Yöntemler

Name	Description
GetSection(String, String)	Belirtilen konumdaki Web uygulamasının yapılandırma dosyasından belirtilen yapılandırma bölümünü alır.
GetSection(String)	Belirtilen yapılandırma bölümünü geçerli Web uygulamasının yapılandırma dosyasından 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, 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.
OpenMachineConfiguration(String, String)	Belirtilen sunucudaki belirtilen makine yapılandırma dosyasını, okuma veya yazma işlemlerine izin vermek için 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.
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.
OpenMappedMachineConfiguration(ConfigurationFileMap)	Makine yapılandırma dosyasını nesne Configuration olarak açar ve belirtilen dosya eşlemesini kullanarak okuma veya yazma işlemlerine izin verir.
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.
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)	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.
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.
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)	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)	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)	Web uygulaması yapılandırma dosyasını, okuma veya yazma işlemlerine izin vermek için belirtilen sanal yolu kullanarak bir Configuration nesne olarak açar.

Ayrıca bkz.

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