WebConfigurationManager.GetWebApplicationSection(String) Yöntem

Tanım

Ad Alanı:

System.Web.Configuration

Bütünleştirilmiş Kod:

System.Web.dll

Belirtilen yapılandırma bölümünü geçerli Web uygulamasının yapılandırma dosyasından alır.

public:
 static System::Object ^ GetWebApplicationSection(System::String ^ sectionName);

public static object GetWebApplicationSection(string sectionName);

static member GetWebApplicationSection : string -> obj

Public Shared Function GetWebApplicationSection (sectionName As String) As Object

Parametreler

sectionName

String

Yapılandırma bölümü adı.

Döndürülenler

Object

Belirtilen yapılandırma bölümü nesnesi veya null bölüm yoksa veya çalışma zamanında bölüme erişilemiyorsa bir iç nesne.

Özel durumlar

ConfigurationErrorsException

Geçerli bir yapılandırma dosyası yüklenemedi.

Örnekler

Aşağıdaki örnekte, yöntemiyle yapılandırma bilgilerine erişme gösterilmektedir GetWebApplicationSection .

Note

Bu örnekte, varsayılan yapılandırma dosyasından GetWebApplicationSection bir ConfigurationSection nesne almak için yönteminin nasıl kullanılacağı gösterilmektedir.

// Show the use of GetWebApplicationSection(string).
// to get the connectionStrings section.
 static void GetWebApplicationSection()
 {

     // Get the default connectionStrings section,
     ConnectionStringsSection connectionStringsSection =
         WebConfigurationManager.GetWebApplicationSection(
         "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 connectionStrings]");
     while (connectionStringsEnum.MoveNext())
     {
         string name = connectionStrings[i].Name;
         Console.WriteLine("Name: {0} Value: {1}",
         name, connectionStrings[name]);
         i += 1;
     }

     Console.WriteLine();
 }

' Show the use of GetWebApplicationSection(string). 
' to access the connectionStrings section.
Shared Sub GetWebApplicationSection()
   
   ' Get the default connectionStrings section,
     Dim connectionStringsSection As ConnectionStringsSection = _
     WebConfigurationManager.GetWebApplicationSection( _
     "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 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

Bir Web uygulamasının içinden çağrılırsa GetWebApplicationSection , bölümü Web uygulaması yapılandırma hiyerarşisine göre sistem tarafından seçilen yapılandırma dosyasından alır.

bir istemci uygulamasının içinden çağırabilirsiniz GetWebApplicationSection . Bu durumda, istemci yapılandırma hiyerarşisine göre sistem tarafından seçilen yapılandırma dosyasından varsayılan bölümü alır. Eşlenmiş bir yapılandırmanız olmadığı sürece bu genellikle Machine.config dosyasıdır. Eşleme yapılandırma dosyaları için, daha sonra açıklanan eşleme yöntemlerine bakın.

Note

GetWebApplicationSection yöntemi, geçerli düzeyde bulunan uygulama yapılandırma dosyasının bölümü üzerinde çalışan bir çalışma zamanı işlemidir. GetSection Ancak yöntemi bir çalışma zamanı işlemi değildir, ancak yapılandırma dosyalarını açma yöntemlerinden biri aracılığıyla elde edilen belirtilen bölüm üzerinde çalışır.

Devralanlara Notlar

Dönüş değeri, kullanımdan önce beklenen yapılandırma türüne yayınlanmalıdır. Olası atama özel durumlarını önlemek için C# içindeki işleç gibi as bir koşullu atama işlemi kullanmanız gerekir.

Ayrıca bkz.

• ConfigurationSection