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 メソッドを使用して構成情報にアクセスする方法を示しています。

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が Web アプリケーション内から呼び出されると、Web アプリケーション構成階層に従って、システムによって選択された構成ファイルからセクションが取得されます。

クライアント アプリケーション内から GetWebApplicationSection を呼び出す場合があります。 この場合、クライアント構成階層に従って、システムによって選択された構成ファイルから既定のセクションが取得されます。 通常、マップされた構成がない限り、これは Machine.config ファイルです。 マッピング構成ファイルについては、次に説明するマッピング方法を参照してください。

Note

GetWebApplicationSection メソッドは、現在のレベルにあるアプリケーション構成ファイルのセクションで動作する実行時操作です。 ただし、 GetSection メソッドは実行時操作ではありませんが、構成ファイルを開くためのメソッドの 1 つを使用して取得した指定されたセクションで動作します。

注意 (継承者)

戻り値は、使用する前に予想される構成の種類にキャストする必要があります。 例外のキャストを回避するには、C# の as 演算子のような条件付きキャスト操作を使用する必要があります。

適用対象

こちらもご覧ください