ConfigurationManager.OpenMappedExeConfiguration メソッド

リファレンス

定義

名前空間:: System.Configuration

アセンブリ:: System.Configuration.ConfigurationManager.dll

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

パッケージ:: System.Configuration.ConfigurationManager v6.0.0

パッケージ:: System.Configuration.ConfigurationManager v7.0.0

パッケージ:: System.Configuration.ConfigurationManager v8.0.0

パッケージ:: System.Configuration.ConfigurationManager v9.0.0-preview.2.24128.5

重要

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

指定したクライアント構成ファイルを Configuration オブジェクトとして開きます。

オーバーロード

OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel)	指定したクライアント構成ファイルを、指定したファイルマップとユーザーレベルを使用する Configuration オブジェクトとして開きます。
OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel, Boolean)	指定したクライアント構成ファイルを、指定したファイルマップ、ユーザーレベル、およびプリロードオプションを使用する Configuration オブジェクトとして開きます。

OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel)

ソース:: ConfigurationManager.cs

ソース:: ConfigurationManager.cs

ソース:: ConfigurationManager.cs

指定したクライアント構成ファイルを、指定したファイルマップとユーザーレベルを使用する Configuration オブジェクトとして開きます。

public:
 static System::Configuration::Configuration ^ OpenMappedExeConfiguration(System::Configuration::ExeConfigurationFileMap ^ fileMap, System::Configuration::ConfigurationUserLevel userLevel);

public static System.Configuration.Configuration OpenMappedExeConfiguration (System.Configuration.ExeConfigurationFileMap fileMap, System.Configuration.ConfigurationUserLevel userLevel);

static member OpenMappedExeConfiguration : System.Configuration.ExeConfigurationFileMap * System.Configuration.ConfigurationUserLevel -> System.Configuration.Configuration

Public Shared Function OpenMappedExeConfiguration (fileMap As ExeConfigurationFileMap, userLevel As ConfigurationUserLevel) As Configuration

パラメーター

fileMap: ExeConfigurationFileMap

アプリケーションの既定の構成ファイルの代わりに使用する構成ファイル。

userLevel: ConfigurationUserLevel

構成を開く対象のユーザーレベルを指定する列挙値の 1 つ。

戻り値

Configuration

構成オブジェクト。

例外

ConfigurationErrorsException

構成ファイルを読み込めませんでした。

例

次のコード例は、メソッドを使用して、 OpenMappedExeConfiguration 構成ファイルに含まれるすべてのセクションを取得する方法を示しています。


   // Access a configuration file using mapping.
   // This function uses the OpenMappedExeConfiguration 
   // method to access a new configuration file.   
   // It also gets the custom ConsoleSection and 
   // sets its ConsoleElement BackgroundColor and
   // ForegroundColor properties to green and red
   // respectively. Then it uses these properties to
   // set the console colors.  
   public static void MapExeConfiguration()
   {

     // Get the application configuration file.
     System.Configuration.Configuration config =
       ConfigurationManager.OpenExeConfiguration(
             ConfigurationUserLevel.None);
   
     Console.WriteLine(config.FilePath);

     if (config == null)
     {
       Console.WriteLine(
         "The configuration file does not exist.");
       Console.WriteLine(
        "Use OpenExeConfiguration to create the file.");
     }

     // Create a new configuration file by saving 
     // the application configuration to a new file.
     string appName = 
       Environment.GetCommandLineArgs()[0];

     string configFile =  string.Concat(appName, 
       ".2.config");
     config.SaveAs(configFile, ConfigurationSaveMode.Full);

     // Map the new configuration file.
     ExeConfigurationFileMap configFileMap = 
         new ExeConfigurationFileMap();
     configFileMap.ExeConfigFilename = configFile;

     // Get the mapped configuration file
    config = 
       ConfigurationManager.OpenMappedExeConfiguration(
         configFileMap, ConfigurationUserLevel.None);

     // Make changes to the new configuration file. 
     // This is to show that this file is the 
     // one that is used.
     string sectionName = "consoleSection";

     ConsoleSection customSection =
       (ConsoleSection)config.GetSection(sectionName);

     if (customSection == null)
     {
         customSection = new ConsoleSection();
         config.Sections.Add(sectionName, customSection);
     }
     else
         // Change the section configuration values.
         customSection =
             (ConsoleSection)config.GetSection(sectionName);

     customSection.ConsoleElement.BackgroundColor =
         ConsoleColor.Green;
     customSection.ConsoleElement.ForegroundColor =
         ConsoleColor.Red;

     // Save the configuration file.
     config.Save(ConfigurationSaveMode.Modified);

     // Force a reload of the changed section. This 
     // makes the new values available for reading.
     ConfigurationManager.RefreshSection(sectionName);

     // Set console properties using the 
     // configuration values contained in the 
     // new configuration file.
     Console.BackgroundColor =
       customSection.ConsoleElement.BackgroundColor;
     Console.ForegroundColor =
       customSection.ConsoleElement.ForegroundColor;
     Console.Clear();

     Console.WriteLine();
     Console.WriteLine("Using OpenMappedExeConfiguration.");
     Console.WriteLine("Configuration file is: {0}", 
       config.FilePath);
   }


' Access a configuration file using mapping.
' This function uses the OpenMappedExeConfiguration 
' method to access a new configuration file.   
' It also gets the custom ConsoleSection and 
' sets its ConsoleElement BackgroundColor and
' ForegroundColor properties to green and red
' respectively. Then it uses these properties to
' set the console colors.  
Public Shared Sub MapExeConfiguration()

    ' Get the application configuration file.
    Dim config As System.Configuration.Configuration = _
    ConfigurationManager.OpenExeConfiguration( _
        ConfigurationUserLevel.None)

    Console.WriteLine(config.FilePath)

    If config Is Nothing Then
        Console.WriteLine( _
        "The configuration file does not exist.")
        Console.WriteLine( _
        "Use OpenExeConfiguration to create file.")
    End If

    ' Create a new configuration file by saving 
    ' the application configuration to a new file.
    Dim appName As String = _
        Environment.GetCommandLineArgs()(0)

    Dim configFile As String = _
        String.Concat(appName, "2.config")
    config.SaveAs(configFile, _
                  ConfigurationSaveMode.Full)

    ' Map the new configuration file.
    Dim configFileMap As New ExeConfigurationFileMap()
    configFileMap.ExeConfigFilename = configFile

    ' Get the mapped configuration file
    config = _
    ConfigurationManager.OpenMappedExeConfiguration( _
        configFileMap, ConfigurationUserLevel.None)

    ' Make changes to the new configuration file. 
    ' This is to show that this file is the 
    ' one that is used.
    Dim sectionName As String = "consoleSection"

    Dim customSection As ConsoleSection = _
        DirectCast(config.GetSection(sectionName),  _
            ConsoleSection)

    If customSection Is Nothing Then
        customSection = New ConsoleSection()
        config.Sections.Add(sectionName, customSection)
    End If

    ' Change the section configuration values.
    customSection = _
        DirectCast(config.GetSection(sectionName),  _
            ConsoleSection)
    customSection.ConsoleElement.BackgroundColor = _
        ConsoleColor.Green
    customSection.ConsoleElement.ForegroundColor = _
        ConsoleColor.Red
    ' Save the configuration file.
    config.Save(ConfigurationSaveMode.Modified)

    ' Force a reload of the changed section. This 
    ' makes the new values available for reading.
    ConfigurationManager.RefreshSection(sectionName)

    ' Set console properties using the 
    ' configuration values contained in the 
    ' new configuration file.
    Console.BackgroundColor = _
        customSection.ConsoleElement.BackgroundColor
    Console.ForegroundColor = _
        customSection.ConsoleElement.ForegroundColor
    Console.Clear()

    Console.WriteLine()
    Console.WriteLine( _
        "Using OpenMappedExeConfiguration.")
    Console.WriteLine( _
        "Configuration file is: {0}", config.FilePath)
End Sub

注釈

オブジェクトは ConfigurationUserLevel 、開いている構成ファイルの場所を決定します。これは、ファイルにユーザーレベルがない (構成ファイルがアプリケーションと同じディレクトリにある) か、ユーザーごとのレベル (構成ファイルがによって userLevel決定されたアプリケーション設定パス内にある) かどうかを示します。

注意

リソースのオブジェクトを取得するには、設定を Configuration 継承するすべての構成ファイルに対する読み取りアクセス許可がコードに必要です。構成ファイルを更新するには、構成ファイルとそれが存在するディレクトリの両方に対する書き込みアクセス許可をコードに追加する必要があります。

こちらもご覧ください

適用対象

OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel, Boolean)

ソース:: ConfigurationManager.cs

ソース:: ConfigurationManager.cs

ソース:: ConfigurationManager.cs

指定したクライアント構成ファイルを、指定したファイルマップ、ユーザーレベル、およびプリロードオプションを使用する Configuration オブジェクトとして開きます。

public:
 static System::Configuration::Configuration ^ OpenMappedExeConfiguration(System::Configuration::ExeConfigurationFileMap ^ fileMap, System::Configuration::ConfigurationUserLevel userLevel, bool preLoad);

public static System.Configuration.Configuration OpenMappedExeConfiguration (System.Configuration.ExeConfigurationFileMap fileMap, System.Configuration.ConfigurationUserLevel userLevel, bool preLoad);

static member OpenMappedExeConfiguration : System.Configuration.ExeConfigurationFileMap * System.Configuration.ConfigurationUserLevel * bool -> System.Configuration.Configuration

Public Shared Function OpenMappedExeConfiguration (fileMap As ExeConfigurationFileMap, userLevel As ConfigurationUserLevel, preLoad As Boolean) As Configuration

パラメーター

fileMap: ExeConfigurationFileMap

アプリケーションの既定の構成ファイルの代わりに使用する構成ファイル。

userLevel: ConfigurationUserLevel

構成を開く対象のユーザーレベルを指定する列挙値の 1 つ。

preLoad: Boolean

すべてのセクショングループとセクションをプリロードする場合は true。それ以外の場合は false。

戻り値

Configuration

構成オブジェクト。

例外

ConfigurationErrorsException

構成ファイルを読み込めませんでした。

注釈

オブジェクトは ConfigurationUserLevel 、開いている構成ファイルの場所を決定します。これは、ファイルにユーザーレベルがない (構成ファイルがアプリケーションと同じディレクトリにある) か、ユーザー単位のレベル (構成ファイルはによって userLevel決定されるアプリケーション設定パス内にある) かどうかを示します。

注意

コード例については、オーバーロードに関するページを OpenMappedExeConfiguration 参照してください。

適用対象

次の方法で共有

ConfigurationManager.OpenMappedExeConfiguration メソッド

定義

オーバーロード

OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel)

パラメーター

戻り値

例外

例

注釈

こちらもご覧ください

適用対象

OpenMappedExeConfiguration(ExeConfigurationFileMap, ConfigurationUserLevel, Boolean)

パラメーター

戻り値

例外

注釈

適用対象

その他のリソース