WebConfigurationManager.GetWebApplicationSection(String) メソッド

定義

名前空間:

System.Web.Configuration

アセンブリ:

System.Web.dll

現在の Web アプリケーションの構成ファイルの、指定した構成セクションを取得します。

C#

public static object GetWebApplicationSection(string sectionName);

パラメーター

sectionName

String

構成セクション名。

戻り値

Object

指定した構成セクション オブジェクト。指定したセクションが存在しない場合は null。このセクションに実行時にアクセスできない場合は内部オブジェクト。

例外

ConfigurationErrorsException

有効な構成ファイルを読み込むことができませんでした。

例

次の例は、 メソッドを使用して構成情報にアクセスする方法を GetWebApplicationSection 示しています。

注意

この例では、 メソッドを使用して、既定の GetWebApplicationSection 構成ファイルからオブジェクトを ConfigurationSection 取得する方法を示します。

C#

// 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();
 }

注釈

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

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

注意

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

注意 (継承者)

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

適用対象

こちらもご覧ください

• ConfigurationSection