WebConfigurationManager.GetWebApplicationSection(String) 方法

定義

命名空間:

System.Web.Configuration

組件:

System.Web.dll

從目前網頁應用程式的設定檔中擷取指定的設定區段。

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

參數

sectionName

String

設定區段名稱。

傳回

Object

指定配置區段物件，或 null 若該區段不存在，則使用內部物件，若該區段在執行時無法存取。

例外狀況

ConfigurationErrorsException

無法載入有效的設定檔。

範例

以下範例說明如何利用該 GetWebApplicationSection 方法存取設定資訊。

Note

這個範例示範如何利用此 GetWebApplicationSection 方法從預設設定檔取得 ConfigurationSection 物件。

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

備註

若 GetWebApplicationSection 從網頁應用程式內部呼叫，系統會依照網頁應用程式設定階層選擇的設定檔區段。

你可以在客戶端應用程式內呼叫 GetWebApplicationSection 。 在這種情況下，它會從系統依據用戶端設定階層所選擇的設定檔中取得預設區段。 通常，這是 Machine.config 檔案，除非你有映射設定。 關於映射設定檔，請參考接下來描述的映射方法。

Note

此 GetWebApplicationSection 方法是一種執行時操作，作用於應用程式設定檔中位於當前層級的區段。 然而，該 GetSection 方法並非執行時操作，而是根據透過開啟設定檔的方法之一所取得的指定區段進行操作。

給繼承者的注意事項

回傳值必須在使用前轉換為預期的配置類型。 為了避免可能的投射異常，你應該使用條件投射操作，就像 C# 裡的 as 運算子一樣。

另請參閱

• ConfigurationSection