WebConfigurationManager クラス

定義

public ref class WebConfigurationManager abstract sealed

public static class WebConfigurationManager

type WebConfigurationManager = class

Public Class WebConfigurationManager

継承

Object

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 クラスを使用すると、コンピューターとアプリケーションの情報にアクセスできます。

web アプリケーションに関連する構成ファイルを操作するには、 WebConfigurationManager を使用することをお勧めします。 クライアント アプリケーションの場合は、 ConfigurationManager クラスを使用します。

アプリケーションでは、次の一覧で説明するように、 System.Configuration 型を拡張したり、構成情報を直接使用して構成情報を処理したりできます。

• Handling configuration。 標準の種類を使用して構成情報を処理するには、次のいずれかの方法を使用します。

  • Accessing a section。 アプリケーションの構成情報にアクセスするには、GetSectionによって提供されるWebConfigurationManagerメソッドのいずれかを使用する必要があります。 <appSettings>と<connectionStrings>では、AppSettingsプロパティとConnectionStringsプロパティを使用します。 これらのメソッドは、読み取り専用操作を実行し、構成の 1 つのキャッシュされたインスタンスを使用し、マルチスレッド対応です。

  • Accessing configuration files。 アプリケーションは、ローカルまたはリモートの任意のレベルで、それ自体または他のアプリケーションまたはコンピューターの構成設定の読み取りと書き込みを行うことができます。 openで提供されている WebConfigurationManager メソッドのいずれかを使用します。 これらのメソッドは Configuration オブジェクトを返します。これにより、基になる構成ファイルを処理するために必要なメソッドとプロパティが提供されます。 これらのメソッドは、読み取りまたは書き込み操作を実行し、ファイルが開かれるたびに構成データを再作成します。

  • Advanced configuration。 より高度な構成処理は、 SectionInformation、 PropertyInformation、 PropertyInformationCollection、 ElementInformation、 ContextInformation、 ConfigurationSectionGroup、および ConfigurationSectionGroupCollectionの種類によって提供されます。

• Extending configuration standard types。 また、プログラムまたは属性付きモデルを使用して、 ConfigurationElement、 ConfigurationElementCollection、 ConfigurationProperty、 ConfigurationSection などの標準の構成の種類を拡張することで、カスタム構成要素を提供することもできます。 標準構成の種類をプログラムで拡張する方法の例については、 ConfigurationSection クラスを参照してください。 属性付きモデルを使用して標準構成の種類を拡張する方法の例については、 ConfigurationElement クラスを参照してください。

注意 (継承者)

Configuration クラスを使用すると、構成ファイルを編集するためのプログラムによるアクセスが可能になります。 WebConfigurationManagerで提供されているオープン メソッドのいずれかを使用します。 これらのメソッドは Configuration オブジェクトを返します。これにより、基になる構成ファイルを処理するために必要なメソッドとプロパティが提供されます。 これらのファイルには、次のように読み取りまたは書き込み用にアクセスできます。

GetSection(String)またはGetSectionGroup(String)を使用して、構成情報を読み取ります。 読み取りを行うユーザーまたはプロセスには、次のアクセス許可が必要です。

• 現在の構成階層レベルの構成ファイルに対する読み取りアクセス許可。

• すべての親構成ファイルに対する読み取りアクセス許可。

アプリケーションで独自の構成への読み取り専用アクセスが必要な場合は、 GetSection メソッドを使用することをお勧めします。 これらのメソッドは、現在のアプリケーションのキャッシュされた構成値へのアクセスを提供します。これは、 Configuration クラスよりもパフォーマンスが向上します。

注: GetSection パラメーターを受け取る静的path メソッドを使用する場合、パス パラメーターはコードが実行されているアプリケーションを参照する必要があります。それ以外の場合、パラメーターは無視され、現在実行中のアプリケーションの構成情報が返されます。

構成情報を書き込むには、 Save のいずれかの方法を使用します。 書き込むユーザーまたはプロセスには、次のアクセス許可が必要です。

• 現在の構成階層レベルの構成ファイルとディレクトリに対する書き込みアクセス許可。

• すべての構成ファイルに対する読み取りアクセス許可。

こちらもご覧ください

• Configuration
• ConfigurationManager
• ASP.NET 構成の概要