WebConfigurationManager.GetWebApplicationSection(String) Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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
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
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.