WebConfigurationManager.GetWebApplicationSection(String) Yöntem

Tanım

Ad Alanı:

System.Web.Configuration

Bütünleştirilmiş Kod:

System.Web.dll

Geçerli Web uygulamasının yapılandırma dosyasından belirtilen yapılandırma bölümünü 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 bölüm çalışma zamanında erişilemiyorsa bir iç nesne.

Özel durumlar

ConfigurationErrorsException

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

Örnekler

Aşağıdaki örnek, yöntemiyle yapılandırma bilgilerine nasıl erişeceklerini GetWebApplicationSection gösterir.

Not

Bu örnekte, varsayılan yapılandırma dosyasından GetWebApplicationSection nesne ConfigurationSection 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ğrısı GetWebApplicationSection gerçekleştirebilirsiniz. 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 yoksa, bu genellikle Machine.config dosyasıdır. Yapılandırma dosyalarını eşlemek için, daha sonra açıklanan eşleme yöntemlerine bakın.

Not

GetWebApplicationSection yöntemi, geçerli düzeyde bulunan uygulama yapılandırma dosyasının bölümüne göre hareket eden 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üme göre hareket eder.

Devralanlara Notlar

Dönüş değeri, kullanılmadan ö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