ConfigurationManager.OpenMachineConfiguration メソッド

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

ConfigurationManager.OpenMachineConfiguration メソッド

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

現在のコンピュータのマシン構成ファイルを Configuration オブジェクトとして開きます。

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

Visual Basic (宣言)

Public Shared Function OpenMachineConfiguration
 As Configuration

Visual Basic (使用法)

Dim returnValue As Configuration

returnValue = ConfigurationManager.OpenMachineConfiguration

C#

public static Configuration OpenMachineConfiguration
 ()

C++

public:
static Configuration^ OpenMachineConfiguration ()

J#

public static Configuration OpenMachineConfiguration
 ()

JScript

public static function OpenMachineConfiguration
 () : Configuration

戻り値
Configuration オブジェクト。

例外

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

解説

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

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

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

使用例

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

Visual Basic

' Get all the sections in machine.config.
' Show how to use the OpenMachineConfiguration method.
Shared Sub GetMachineSections()
   ' Get the machine.config file.
     Dim config As System.Configuration.Configuration
 = _
     ConfigurationManager.OpenMachineConfiguration()
   
   ' 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.ToString() + _
         ControlChars.Tab + _
         section.SectionInformation.AllowExeDefinition.ToString()))
      i += 1
   Next section 
     Console.WriteLine("[Total number of sections: {0}]",
 i.ToString())
   
   ' Display machine.config path.
   Console.WriteLine("[File path: {0}]", config.FilePath)
End Sub 'GetMachineSections
 

C#

// Get all the sections in machine.config.
// Show how to use the OpenMachineConfiguration method.
static void GetMachineSections()
{
    // Get the machine.config file.
    System.Configuration.Configuration config =
            ConfigurationManager.OpenMachineConfiguration();

    // 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 クラス