ConfigurationManager.OpenMappedMachineConfiguration メソッド

.NET Framework クラス ライブラリ リファレンス

ConfigurationManager.OpenMappedMachineConfiguration メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

指定したファイル マップを使用して、マシン構成ファイルを Configuration オブジェクトとして開きます。

名前空間: System.Configuration
アセンブリ: System.Configuration (system.configuration.dll 内)
構文

Visual Basic (宣言)

Public Shared Function OpenMappedMachineConfiguration
 ( _
    fileMap As ConfigurationFileMap _
) As Configuration

Visual Basic (使用法)

Dim fileMap As ConfigurationFileMap
Dim returnValue As Configuration

returnValue = ConfigurationManager.OpenMappedMachineConfiguration(fileMap)

C#

public static Configuration OpenMappedMachineConfiguration
 (
    ConfigurationFileMap fileMap
)

C++

public:
static Configuration^ OpenMappedMachineConfiguration (
    ConfigurationFileMap^ fileMap
)

J#

public static Configuration OpenMappedMachineConfiguration
 (
    ConfigurationFileMap fileMap
)

JScript

public static function OpenMappedMachineConfiguration
 (
    fileMap : ConfigurationFileMap
) : Configuration

パラメータ

fileMap

アプリケーションの既定の構成ファイルの代わりに使用する構成ファイルを参照する ExeConfigurationFileMap オブジェクト。

戻り値
Configuration オブジェクト。

例外

例外の種類	条件
ConfigurationErrorsException	構成ファイルを読み込むことができませんでした。

解説

マシン構成設定は、ローカル アプリケーション用にオーバーライドされている場合を除き、コンピュータ全体とそのコンピュータに存在するすべてのアプリケーションに適用されます。マシン構成設定は、.NET Framework の現在実行中のバージョンの Machine.config ファイルから読み取られます。Machine.config ファイルは、次のサブディレクトリにあります。

%windir%\Microsoft.NET\Framework\version\config

メモ
リソースの Configuration オブジェクトを取得するには、設定の継承元となるすべての構成ファイルに対する読み取り特権がコードに付与されている必要があります。構成ファイルを更新するには、構成ファイルとそれを格納するディレクトリの両方に対する書き込み特権も、コードに付与されている必要があります。コンピュータにインストールされている可能性のある .NET Framework の他のバージョンの Machine.config ファイルにはアクセスできません。

使用例

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

Visual Basic

' Get all the sections in the mapped machine.config.
' Show how to use the 
' OpenMappedMachineConfiguration(fileMap) method.
Shared Sub GetMappedMachineSections()
   ' Get the machine.config file.
   Dim fileMap As New ConfigurationFileMap()
   ' You may want to map to your own machine.comfig file here.
     fileMap.MachineConfigFilename = _
     "C:\WINNT\Microsoft.NET\Framework\v2.0.50223\CONFIG\machine.config"
     Dim config As System.Configuration.Configuration
 = _
     ConfigurationManager.OpenMappedMachineConfiguration(fileMap)
   
   ' Loop to get the sections. Display basic information.
   Console.WriteLine("Name, Allow Definition")
   Dim i As Integer = 0
   Dim section As ConfigurationSection
   For Each section In 
 config.Sections
         Console.WriteLine(( _
         section.SectionInformation.Name + _
         ControlChars.Tab + _
         section.SectionInformation.AllowExeDefinition.ToString()))
      i += 1
   Next section 
   Console.WriteLine("[Total number of sections: {0}]",
 i)
   
   ' Display machine.config path.
   Console.WriteLine("[File path: {0}]", config.FilePath)
End Sub 'GetMappedMachineSections
 

C#

// Get all the sections in the mapped machine.config.
// Show how to use the 
// OpenMappedMachineConfiguration(fileMap) method.
static void GetMappedMachineSections()
{
    // Get the machine.config file.
    ConfigurationFileMap fileMap = 
        new ConfigurationFileMap();
    // You may want to map to your own machine.comfig file here.
    fileMap.MachineConfigFilename = 
        @"C:\WINNT\Microsoft.NET\Framework\v2.0.50223\CONFIG\machine.config";
    System.Configuration.Configuration config =
        ConfigurationManager.OpenMappedMachineConfiguration(fileMap);

    // Loop to get the sections. Display basic information.
    Console.WriteLine("Name, Allow Definition");
    int i = 0;
    foreach (ConfigurationSection section in
 config.Sections)
    {
        Console.WriteLine(
            section.SectionInformation.Name + "\t" +
        section.SectionInformation.AllowExeDefinition);
        i += 1;

    }
    Console.WriteLine("[Total number of sections: {0}]", i);

    // Display machine.config path.
    Console.WriteLine("[File path: {0}]", config.FilePath);

}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ConfigurationManager クラス
ConfigurationManager メンバ
System.Configuration 名前空間
Configuration クラス
ConfigurationFileMap クラス