WebConfigurationManager クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
Web アプリケーションに適用される構成ファイルにアクセスできるようにします。
public ref class WebConfigurationManager abstract sealed
public static class WebConfigurationManager
type WebConfigurationManager = class
Public Class WebConfigurationManager
- 継承
-
WebConfigurationManager
例
次の例は、次のコマンドを使用して構成情報にアクセスする方法を示しています。
GetSection メソッド
// 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
注釈
この WebConfigurationManager クラスを使用すると、コンピューターとアプリケーションの情報にアクセスできます。
使用 WebConfigurationManager は、Web アプリケーションに関連する構成ファイルを操作するための推奨される方法です。 クライアント アプリケーションの場合は、クラスを使用します ConfigurationManager 。
次の一覧で説明するように、アプリケーションで型を System.Configuration 拡張したり、それらを直接使用して構成情報を処理したりできます。
Handling configuration
. 標準の種類を使用して構成情報を処理するには、次のいずれかの方法を使用します。Accessing a section
. アプリケーションの構成情報にアクセスするには、次のいずれかの方法をGetSection
使用する WebConfigurationManager必要があります。 の<appSettings>
場合と<connectionStrings>
、プロパティを使用しますAppSettingsConnectionStrings。 これらのメソッドは、読み取り専用操作を実行し、構成の単一のキャッシュされたインスタンスを使用し、マルチスレッド対応です。Accessing configuration files
. アプリケーションは、ローカルまたはリモートで、それ自体または他のアプリケーションやコンピューターに対して、任意のレベルで構成設定の読み取りと書き込みを行うことができます。 によって提供されるopen
WebConfigurationManagerメソッドのいずれかを使用します。 これらのメソッドは、基になる構成ファイルを Configuration 処理するために必要なメソッドとプロパティを提供するオブジェクトを返します。 これらのメソッドは、読み取りまたは書き込み操作を実行し、ファイルが開かれるたびに構成データを再作成します。Advanced configuration
. より高度な構成処理は、型SectionInformation、、PropertyInformation、PropertyInformationCollection、ElementInformationContextInformationConfigurationSectionGroup、およびConfigurationSectionGroupCollectionによって提供されます。
Extending configuration standard types
. カスタム構成要素を提供するには、標準の構成の種類 (、ConfigurationElementCollectionConfigurationProperty、 ConfigurationElementなど) を拡張しConfigurationSection、プログラムまたは属性付きモデルを使用します。 標準構成の種類を ConfigurationSection プログラムで拡張する方法の例については、クラスを参照してください。 属性付きモデルを ConfigurationElement 使用して標準構成の種類を拡張する方法の例については、クラスを参照してください。
注意 (継承者)
このクラスを Configuration 使用すると、構成ファイルを編集するためのプログラムによるアクセスが許可されます。 によって提供される WebConfigurationManagerオープン メソッドのいずれかを使用します。 これらのメソッドは、基になる構成ファイルを Configuration 処理するために必要なメソッドとプロパティを提供するオブジェクトを返します。 これらのファイルには、次のように読み取りまたは書き込み用にアクセスできます。 構成情報を使用 GetSection(String) または GetSectionGroup(String) 読み取ります。 読み取りを行うユーザーまたはプロセスには、次のアクセス許可が必要です。
現在の構成階層レベルの構成ファイルに対する読み取りアクセス許可。
すべての親構成ファイルに対する読み取りアクセス許可。
アプリケーションで独自の構成への読み取り専用アクセスが必要な場合は、この方法を GetSection 使用することをお勧めします。 これらのメソッドは、現在のアプリケーションのキャッシュされた構成値へのアクセスを提供します。これは、クラスよりもパフォーマンスが Configuration 優れています。
注: パラメーターを受け取るpath
静的GetSection
メソッドを使用する場合、path パラメーターはコードが実行されているアプリケーションを参照する必要があります。それ以外の場合、パラメーターは無視され、現在実行中のアプリケーションの構成情報が返されます。
構成情報を Save 書き込むには、いずれかの方法を使用します。 書き込みを行うユーザーまたはプロセスには、次のアクセス許可が必要です。
現在の構成階層レベルの構成ファイルとディレクトリに対する書き込みアクセス許可。
すべての構成ファイルに対する読み取りアクセス許可。
プロパティ
AppSettings |
Web サイトのアプリケーション設定を取得します。 |
ConnectionStrings |
Web サイトの接続文字列を取得します。 |
メソッド
GetSection(String) |
現在の Web アプリケーションの構成ファイルの、指定した構成セクションを取得します。 |
GetSection(String, String) |
指定された場所にある Web アプリケーションの構成ファイルの、指定した構成セクションを取得します。 |
GetWebApplicationSection(String) |
現在の Web アプリケーションの構成ファイルの、指定した構成セクションを取得します。 |
OpenMachineConfiguration() |
現在のコンピューター上のマシン構成ファイルを Configuration オブジェクトとして開き、読み取りまたは書き込みができるようにします。 |
OpenMachineConfiguration(String) |
現在のコンピューター上のマシン構成ファイルを Configuration オブジェクトとして開き、読み取りまたは書き込みができるようにします。 |
OpenMachineConfiguration(String, String) |
指定したサーバー上の指定したマシン構成ファイルを Configuration オブジェクトとして開き、読み取りまたは書き込みができるようにします。 |
OpenMachineConfiguration(String, String, IntPtr) |
セキュリティ コンテキストを使用して、指定したサーバー上の指定したマシン構成ファイルを Configuration オブジェクトとして開き、読み取りまたは書き込みができるようにします。 |
OpenMachineConfiguration(String, String, String, String) |
セキュリティ コンテキストを使用して、指定したサーバー上の指定したマシン構成ファイルを Configuration オブジェクトとして開き、読み取りまたは書き込みができるようにします。 |
OpenMappedMachineConfiguration(ConfigurationFileMap) |
指定したファイル マップを使用して、マシン構成ファイルを Configuration オブジェクトとして開き、読み取りまたは書き込みができるようにします。 |
OpenMappedMachineConfiguration(ConfigurationFileMap, String) |
指定したファイル マップと場所を使用して、マシン構成ファイルを Configuration オブジェクトとして開き、読み取りまたは書き込みができるようにします。 |
OpenMappedWebConfiguration(WebConfigurationFileMap, String) |
指定したファイル マップと仮想パスを使用して、指定した Web アプリケーション構成ファイルを Configuration オブジェクトとして開き、読み取りまたは書き込みができるようにします。 |
OpenMappedWebConfiguration(WebConfigurationFileMap, String, String) |
指定したファイル マップ、仮想パス、およびサイト名を使用して、指定した Web アプリケーション構成ファイルを Configuration オブジェクトとして開き、読み取りまたは書き込みができるようにします。 |
OpenMappedWebConfiguration(WebConfigurationFileMap, String, String, String) |
指定したファイル マップ、仮想パス、サイト名、および場所を使用して、指定した Web アプリケーション構成ファイルを Configuration オブジェクトとして開き、読み取りまたは書き込みができるようにします。 |
OpenWebConfiguration(String) |
指定した仮想パスを使用して、Web アプリケーション構成ファイルを Configuration オブジェクトとして開き、読み取りまたは書き込みができるようにします。 |
OpenWebConfiguration(String, String) |
指定した仮想パスとサイト名を使用して、Web アプリケーション構成ファイルを Configuration オブジェクトとして開き、読み取りまたは書き込みができるようにします。 |
OpenWebConfiguration(String, String, String) |
指定した仮想パス、サイト名、および場所を使用して、Web アプリケーション構成ファイルを Configuration オブジェクトとして開き、読み取りまたは書き込みができるようにします。 |
OpenWebConfiguration(String, String, String, String) |
指定した仮想パス、サイト名、場所、およびサーバーを使用して、Web アプリケーション構成ファイルを Configuration オブジェクトとして開き、読み取りまたは書き込みができるようにします。 |
OpenWebConfiguration(String, String, String, String, IntPtr) |
指定した仮想パス、サイト名、場所、サーバー、およびセキュリティ コンテキストを使用して、Web アプリケーション構成ファイルを Configuration オブジェクトとして開き、読み取りまたは書き込みができるようにします。 |
OpenWebConfiguration(String, String, String, String, String, String) |
指定した仮想パス、サイト名、場所、サーバー、およびセキュリティ コンテキストを使用して、Web アプリケーション構成ファイルを Configuration オブジェクトとして開き、読み取りまたは書き込みができるようにします。 |