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

注釈

が Web アプリケーション内から呼び出された場合 GetWebApplicationSection は、Web アプリケーション構成階層に従って、システムによって選択された構成ファイルからセクションが取得されます。

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

Note

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

注意 (継承者)

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

こちらもご覧ください

• ConfigurationSection