WebConfigurationManager.GetSection メソッド

リファレンス

定義

名前空間:: System.Web.Configuration

アセンブリ:: System.Web.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

オーバーロード

GetSection(String)	現在の Web アプリケーションの構成ファイルの、指定した構成セクションを取得します。
GetSection(String, String)	指定された場所にある Web アプリケーションの構成ファイルの、指定した構成セクションを取得します。

GetSection(String)

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

public:
 static System::Object ^ GetSection(System::String ^ sectionName);

public static object GetSection (string sectionName);

static member GetSection : string -> obj

Public Shared Function GetSection (sectionName As String) As Object

パラメーター

sectionName: String

構成セクション名。

戻り値

Object

指定した構成セクションオブジェクト。指定したセクションが存在しない場合は null。 GetSection(String) を実行時の操作として使用する場合は、セキュリティ上の制限に注意してください。たとえば、実行時には変更のためにセクションにアクセスできない場合があります。

例外

ConfigurationErrorsException

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

例

このセクションの例では、メソッドを使用して構成情報にアクセスする方法を GetSection 示します。

次の例は、Web アプリケーションまたはコンソールアプリケーションからアクセスできるセクションを示しています。

注意

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


// Show how to use the GetSection(string). 
// to access the connectionStrings section.
static void GetConnectionStringsSection()
{

    // Get the connectionStrings section.
    ConnectionStringsSection connectionStringsSection =
        WebConfigurationManager.GetSection("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 the connectionStrings]");
    while (connectionStringsEnum.MoveNext())
    {
        string name = connectionStrings[i].Name;
        Console.WriteLine("Name: {0} Value: {1}",
        name, connectionStrings[name]);
        i += 1;
    }

    Console.WriteLine();
}

' Show how to use the GetSection(string). 
' to access the connectionStrings section.
Shared Sub GetConnectionStringsSection()
   
   ' Get the connectionStrings section.
     Dim connectionStringsSection As ConnectionStringsSection = _
     WebConfigurationManager.GetSection("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 the 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 アプリケーション内から呼び出された場合 GetSection は、Web アプリケーション構成階層に従って、システムによって選択された構成ファイルからセクションを取得します。

注意事項

アプリケーションで HTTP とは異なるプロトコルを使用する場合、 GetSection セクション名とそのパラメーターリスト内のパスの両方を受け取るオーバーロードが使用されます。構成階層レベルに関する前提をシステムで行うことができないため、構成ファイルのパスを指定する必要があります。セクション名のみを受け取るオーバーロードを使用 GetSection すると、システムは常にアプリケーションレベルで構成設定を返そうとします。ただし、指定したパスが現在のアプリケーションの外部にある場合、パスを受け取るオーバーロードは、現在実行中のアプリケーションのアプリケーションレベルの構成設定も返されることに注意してください。

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

注意

この GetSection メソッドは、アプリケーションが実行される階層レベルで構成ファイルのセクションを操作する実行時メソッドです。実行時以外の操作の場合は、代わりに使用 GetSection します。このメソッドは、構成ファイルを開くオーバーロードされたメソッドの 1 つを使用して取得する構成ファイル OpenWebConfigurationの指定されたセクションで動作します。

注意 (継承者)

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

こちらもご覧ください

ConfigurationSection

適用対象

GetSection(String, String)

指定された場所にある Web アプリケーションの構成ファイルの、指定した構成セクションを取得します。

public:
 static System::Object ^ GetSection(System::String ^ sectionName, System::String ^ path);

public static object GetSection (string sectionName, string path);

static member GetSection : string * string -> obj

Public Shared Function GetSection (sectionName As String, path As String) As Object

パラメーター

sectionName: String

構成セクション名。

path: String

仮想構成ファイルパス。

戻り値

Object

指定した構成セクションオブジェクト。指定したセクションが存在しない場合は null。 GetSection(String, String) を実行時の操作として使用するには、セキュリティ上の制限があることに注意してください。たとえば、実行時に変更のためにセクションにアクセスできない場合があります。

例外

InvalidOperationException

メソッドが Web アプリケーション以外から呼び出されています。

ConfigurationErrorsException

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

例

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

注意

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


// Show the use of GetSection(string, string). 
// to access the connectionStrings section.
 static void GetSection2()
 {

     try
     {
         // Get the connectionStrings section for the 
         // specified Web app. This GetSection overload
         // can olny be called from within a Web application.
         ConnectionStringsSection connectionStringsSection =
             WebConfigurationManager.GetSection("connectionStrings",
             "/configTest") 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();
     }

     catch (InvalidOperationException e)
     {
         string errorMsg = e.ToString();
         Console.WriteLine(errorMsg);
     }
 }

' Show the use of GetSection(string, string). 
' to access the connectionStrings section.
Shared Sub GetSection2()
   
   Try
      ' Get the connectionStrings section for the 
      ' specified Web app. This GetSection overload
      ' can olny be called from within a Web application.
         Dim connectionStringsSection As ConnectionStringsSection = _
         WebConfigurationManager.GetSection( _
         "connectionStrings", "/configTest")
      
      ' 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()
   
   Catch e As InvalidOperationException
      Dim errorMsg As String = e.ToString()
      Console.WriteLine(errorMsg)
   End Try
End Sub

注釈

Web アプリケーション内から呼び出された場合 GetSection は、構成階層内の指定したパスで定義された構成ファイルからセクションを取得します。

注意事項

このメソッドは、クライアントアプリケーション内から呼び出すことはできません。

現在の Web アプリケーションディレクトリレベルにある構成ファイルから構成セクションを取得する場合は、このメソッドを GetSection 使用します。

注意

この GetSection メソッドは、アプリケーションが実行される階層レベルの構成ファイルのセクションで動作する実行時メソッドです。実行時以外の操作の場合は、代わりに使用 GetSection します。このメソッドは、構成ファイルのいずれかの方法を使用して取得する構成ファイルの指定されたセクションで open 動作します。

注意 (継承者)

こちらもご覧ください

ConfigurationSection

適用対象

次の方法で共有

WebConfigurationManager.GetSection メソッド

定義

オーバーロード

GetSection(String)

パラメーター

戻り値

例外

例

注釈

注意 (継承者)

こちらもご覧ください

適用対象

GetSection(String, String)

パラメーター

戻り値

例外

例

注釈

注意 (継承者)

こちらもご覧ください

適用対象

その他のリソース