WebConfigurationManager.GetWebApplicationSection(String) 方法

定義

命名空間:

System.Web.Configuration

組件:

System.Web.dll

從目前 Web 應用程式的組態檔中擷取指定的組態區段。

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 。

注意

此範例示範如何使用 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 從 Web 應用程式內呼叫 ，它會根據 Web 應用程式組態階層，從系統所選取的組態檔中取得 區段。

您可以從用戶端應用程式內呼叫 GetWebApplicationSection 。 在此情況下，它會根據用戶端組態階層，從系統所選取的組態檔取得預設區段。 通常，這是Machine.config檔案，除非您已有對應的組態。 如需對應組態檔，請參閱接下來所述的對應方法。

注意

方法是 GetWebApplicationSection 執行時間作業，可在位於目前層級的應用程式組態檔區段上運作。 GetSection不過，方法不是執行時間作業，而是對透過其中一個開啟組態檔的方法取得的指定區段執行動作。

給繼承者的注意事項

傳回值必須先轉換成預期的組態類型，才能使用。 若要避免可能的轉換例外狀況，您應該使用條件式轉換作業，例如 as C# 中的 運算子。

另請參閱

• ConfigurationSection