WebConfigurationManager.GetSection メソッド

定義

名前空間:

Microsoft.Web.Administration

アセンブリ:

Microsoft.Web.Administration.dll

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

オーバーロード

GetSection(String)	現在のアプリケーションの構成ファイルから、指定した構成セクションを取得します。
GetSection(HttpContext, String)	指定したコンテキストとの関係にあるアプリケーションの構成ファイルから、指定した構成セクションを取得します。
GetSection(String, String, String)	Web サイト名、仮想パス、セクション パスを使用して、指定した構成セクションを取得します。
GetSection(HttpContext, String, Type)	指定したコンテキストとの関係にあるアプリケーションの構成ファイルから、指定した構成セクションの種類を使用して、指定した構成セクションを取得します。
GetSection(String, String, String, Type)	Web サイト名、仮想パス、セクション パス、および実行時の種類を使用して、指定した構成セクションを取得します。

GetSection(String)

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

public:
 static Microsoft::Web::Administration::ConfigurationSection ^ GetSection(System::String ^ sectionPath);

public static Microsoft.Web.Administration.ConfigurationSection GetSection (string sectionPath);

static member GetSection : string -> Microsoft.Web.Administration.ConfigurationSection

Public Shared Function GetSection (sectionPath As String) As ConfigurationSection

パラメーター

sectionPath

String

構成セクション名。

戻り値

ConfigurationSection

指定した構成セクション オブジェクト。指定したセクションが存在しない場合は null。

例外

ConfigurationErrorsException

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

注釈

オーバーロードが GetSection(String) Web アプリケーション内から呼び出されると、Web アプリケーションの構成階層に従ってシステムによって選択された構成ファイルから セクションが返されます。

注意事項

アプリケーションで HTTP 以外のプロトコルを使用する場合は、 または GetSection(String, String, String, Type) オーバーロードを使用GetSection(HttpContext, String)する必要があります。このオーバーロードは、それぞれセクション名とパラメーター リスト内のオブジェクトの両方をSystem.Web.HttpContext受け取ります。 システムが HttpContext 特定の構成階層レベルで構成設定を返せるようにするには、 を指定する必要があります。 ただし、指定した構成パスが現在のアプリケーションの外部にありGetSection(String, String, String, Type)、GetSection現在実行中のアプリケーションのアプリケーション レベルの構成設定が返される場合。 セクション名のみを受け取る を使用 GetSection(String)する場合、システムは常にアプリケーション レベルで構成設定を返そうとします。

重要

を実行時操作として使用 GetSection(String) することは、セキュリティ制限によって制限されます。 たとえば、実行時にセクションにアクセスしたり変更したりできない場合があります。

GetSection(HttpContext, String)

指定したコンテキストとの関係にあるアプリケーションの構成ファイルから、指定した構成セクションを取得します。

public:
 static Microsoft::Web::Administration::ConfigurationSection ^ GetSection(System::Web::HttpContext ^ context, System::String ^ sectionPath);

public static Microsoft.Web.Administration.ConfigurationSection GetSection (System.Web.HttpContext context, string sectionPath);

static member GetSection : System.Web.HttpContext * string -> Microsoft.Web.Administration.ConfigurationSection

Public Shared Function GetSection (context As HttpContext, sectionPath As String) As ConfigurationSection

パラメーター

context

HttpContext

現在の要求の HttpContext。

sectionPath

String

構成セクション名。

戻り値

ConfigurationSection

指定した構成セクション オブジェクト。指定したセクションが存在しない場合は null。

例外

ConfigurationErrorsException

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

注釈

オーバーロードが GetSection(HttpContext, String) Web アプリケーション内から呼び出された場合、Web アプリケーションの オブジェクトに従って System.Web.HttpContext システムによって選択された構成ファイルから セクションが返されます。

注意事項

アプリケーションで HTTP 以外のプロトコルを使用する場合は、 または GetSection(String, String, String, Type) オーバーロードを使用GetSection(HttpContext, String)する必要があります。このオーバーロードは、それぞれセクション名と パラメーター リストの 両方をHttpContext受け取ります。 システムが HttpContext 特定の構成階層レベルで構成設定を返せるようにするには、 を指定する必要があります。 ただし、指定した構成パスが現在のアプリケーションの外部にありGetSection(String, String, String, Type)、GetSection(HttpContext, String)現在実行中のアプリケーションのアプリケーション レベルの構成設定が返される場合。 セクション名のみを受け取るオーバーロードを GetSection(String) 使用する場合、システムは常にアプリケーション レベルで構成設定を返そうとします。

重要

を実行時操作として使用 GetSection(HttpContext, String) することは、セキュリティ制限によって制限されます。 たとえば、実行時にセクションにアクセスしたり変更したりできない場合があります。

GetSection(String, String, String)

Web サイト名、仮想パス、セクション パスを使用して、指定した構成セクションを取得します。

public:
 static Microsoft::Web::Administration::ConfigurationSection ^ GetSection(System::String ^ siteName, System::String ^ virtualPath, System::String ^ sectionPath);

public static Microsoft.Web.Administration.ConfigurationSection GetSection (string siteName, string virtualPath, string sectionPath);

static member GetSection : string * string * string -> Microsoft.Web.Administration.ConfigurationSection

Public Shared Function GetSection (siteName As String, virtualPath As String, sectionPath As String) As ConfigurationSection

パラメーター

siteName

String

Web サイトの名前。

virtualPath

String

Web.config ファイルの仮想パス。

sectionPath

String

構成セクション名。

戻り値

ConfigurationSection

ConfigurationSection オブジェクト。

例外

ConfigurationErrorsException

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

ArgumentNullException

メソッドに渡されるパラメーターの 1 つは です null。

注釈

オーバーロードは GetSection(String, String, String) 、 ConfigurationSection 要求された場所の構成を表す オブジェクトを返します。 このメソッドは、最初に パラメーターで要求された Web サイトを siteName 検索し、指定した 内のWeb.config ファイルを検索します virtualPath。 GetSection(String, String, String) 次に、Web.config ファイルで要求された構成 sectionPathを検索します。

大事な を実行時操作として使用 GetSection(String, String, String) することは、セキュリティ制限によって制限されます。 たとえば、実行時にセクションにアクセスしたり変更したりできない場合があります

GetSection(HttpContext, String, Type)

指定したコンテキストとの関係にあるアプリケーションの構成ファイルから、指定した構成セクションの種類を使用して、指定した構成セクションを取得します。

public:
 static Microsoft::Web::Administration::ConfigurationSection ^ GetSection(System::Web::HttpContext ^ context, System::String ^ sectionPath, Type ^ sectionType);

public static Microsoft.Web.Administration.ConfigurationSection GetSection (System.Web.HttpContext context, string sectionPath, Type sectionType);

static member GetSection : System.Web.HttpContext * string * Type -> Microsoft.Web.Administration.ConfigurationSection

Public Shared Function GetSection (context As HttpContext, sectionPath As String, sectionType As Type) As ConfigurationSection

パラメーター

context

HttpContext

HttpContext現在の要求の オブジェクト。

sectionPath

String

構成セクション名。

sectionType

Type

構成セクションの種類

戻り値

ConfigurationSection

指定した構成セクション オブジェクト。指定したセクションが存在しない場合は null。

例外

ConfigurationErrorsException

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

ArgumentNullException

メソッドに渡されるパラメーターの 1 つは です null。

InvalidOperationException

パラメーターの sectionType 値は、 クラスから ConfigurationSection 派生していないか、パブリック コンストラクターを提供しません。

注釈

オーバーロードが GetSection(HttpContext, String, Type) Web アプリケーション内から呼び出された場合は、Web アプリケーションの オブジェクトに従ってSystem.Web.HttpContextシステムによって選択された構成ファイルから セクションと、指定された パラメーターと sectionType パラメーターがsectionPath返されます。

注意事項

アプリケーションで HTTP 以外のプロトコルを使用する場合は、 または GetSection(String, String, String, Type) オーバーロードを使用GetSection(HttpContext, String)する必要があります。このオーバーロードは、それぞれセクション名と パラメーター リストの 両方をHttpContext受け取ります。 システムが HttpContext 特定の構成階層レベルで構成設定を返せるようにするには、 を指定する必要があります。 ただし、指定した構成パスが現在のアプリケーションの外部にありGetSection(String, String, String, Type)、GetSection(HttpContext, String)現在実行中のアプリケーションのアプリケーション レベルの構成設定が返される場合。 セクション名のみを受け取るオーバーロードを GetSection(String) 使用する場合、システムは常にアプリケーション レベルで構成設定を返そうとします。

重要

を実行時操作として使用 GetSection(HttpContext, String, Type) することは、セキュリティ制限によって制限されます。 たとえば、実行時にセクションにアクセスしたり変更したりできない場合があります。

GetSection(String, String, String, Type)

Web サイト名、仮想パス、セクション パス、および実行時の種類を使用して、指定した構成セクションを取得します。

public:
 static Microsoft::Web::Administration::ConfigurationSection ^ GetSection(System::String ^ siteName, System::String ^ virtualPath, System::String ^ sectionPath, Type ^ sectionType);

public static Microsoft.Web.Administration.ConfigurationSection GetSection (string siteName, string virtualPath, string sectionPath, Type sectionType);

static member GetSection : string * string * string * Type -> Microsoft.Web.Administration.ConfigurationSection

Public Shared Function GetSection (siteName As String, virtualPath As String, sectionPath As String, sectionType As Type) As ConfigurationSection

パラメーター

siteName

String

Web サイトの名前。

virtualPath

String

Web.config ファイルの仮想パス。

sectionPath

String

構成セクション名。

sectionType

Type

構成セクションの実行時の種類。

戻り値

ConfigurationSection

ConfigurationSection オブジェクト。

注釈

オーバーロードは GetSection(String, String, String, Type) 、 ConfigurationSection 要求された場所の構成を表す オブジェクトを返します。 このメソッドは、最初に パラメーターで要求された Web サイトを siteName 検索し、指定した 内のWeb.config ファイルを検索します virtualPath。 GetSection(String, String, String, Type) 次に、Web.config ファイルで、 パラメーターに指定された実行時の型と一致する要求された構成 sectionPath を sectionType 検索します。

重要

を実行時操作として使用 GetSection(String, String, String, Type) することは、セキュリティ制限によって制限されます。 たとえば、実行時にセクションにアクセスしたり変更したりできない場合があります。