WebConfigurationManager.OpenMachineConfiguration Metode

Definisi

Ruang nama:

System.Web.Configuration

Rakitan:

System.Web.dll

Membuka file konfigurasi komputer sebagai Configuration objek untuk mengizinkan operasi baca atau tulis.

Overload

OpenMachineConfiguration()	Membuka file konfigurasi komputer pada komputer saat ini sebagai Configuration objek untuk memperbolehkan operasi baca atau tulis.
OpenMachineConfiguration(String)	Membuka file konfigurasi komputer pada komputer saat ini sebagai Configuration objek untuk memperbolehkan operasi baca atau tulis.
OpenMachineConfiguration(String, String)	Membuka file konfigurasi komputer yang ditentukan pada server yang ditentukan sebagai Configuration objek untuk mengizinkan operasi baca atau tulis.
OpenMachineConfiguration(String, String, IntPtr)	Membuka file konfigurasi komputer yang ditentukan pada server yang ditentukan sebagai Configuration objek, menggunakan konteks keamanan yang ditentukan untuk mengizinkan operasi baca atau tulis.
OpenMachineConfiguration(String, String, String, String)	Membuka file konfigurasi komputer yang ditentukan pada server yang ditentukan sebagai Configuration objek, menggunakan konteks keamanan yang ditentukan untuk mengizinkan operasi baca atau tulis.

OpenMachineConfiguration()

Membuka file konfigurasi komputer pada komputer saat ini sebagai Configuration objek untuk memperbolehkan operasi baca atau tulis.

public:
 static System::Configuration::Configuration ^ OpenMachineConfiguration();

public static System.Configuration.Configuration OpenMachineConfiguration ();

static member OpenMachineConfiguration : unit -> System.Configuration.Configuration

Public Shared Function OpenMachineConfiguration () As Configuration

Mengembalikan

Configuration

Objek Configuration.

Pengecualian

ConfigurationErrorsException

File konfigurasi yang valid tidak dapat dimuat.

Contoh

Contoh berikut menunjukkan cara mengakses informasi konfigurasi dengan OpenMachineConfiguration metode .

// Show how to use OpenMachineConfiguration().
// It gets the machine.config file on the current 
// machine and displays section information. 
static void OpenMachineConfiguration1()
{
    // Get the machine.config file on the current machine.
    System.Configuration.Configuration config =
            WebConfigurationManager.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); 
}

' Show how to use OpenMachineConfiguration().
' It gets the machine.config file on the current 
' machine and displays section information. 
Shared Sub OpenMachineConfiguration1()
   ' Get the machine.config file on the current machine.
     Dim config As System.Configuration.Configuration = _
     WebConfigurationManager.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 + _
         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

Keterangan

Metode ini OpenMachineConfiguration membuka file konfigurasi komputer di komputer tempat aplikasi berjalan. File ini terletak di direktori build standar %windir%\Microsoft.NET\Framework\version\config.

Lihat juga

• Configuration

OpenMachineConfiguration(String)

Membuka file konfigurasi komputer pada komputer saat ini sebagai Configuration objek untuk memperbolehkan operasi baca atau tulis.

public:
 static System::Configuration::Configuration ^ OpenMachineConfiguration(System::String ^ locationSubPath);

public static System.Configuration.Configuration OpenMachineConfiguration (string locationSubPath);

static member OpenMachineConfiguration : string -> System.Configuration.Configuration

Public Shared Function OpenMachineConfiguration (locationSubPath As String) As Configuration

Parameter

locationSubPath

String

Jalur aplikasi tempat konfigurasi komputer berlaku.

Mengembalikan

Configuration

Objek Configuration.

Pengecualian

ConfigurationErrorsException

File konfigurasi yang valid tidak dapat dimuat.

Contoh

Contoh berikut menunjukkan cara mengakses informasi konfigurasi dengan OpenMachineConfiguration metode .

// Show how to use OpenMachineConfiguration(string).
// It gets the machine.config file applicabe to the
// specified resource and displays section 
// basic information. 
static void OpenMachineConfiguration2()
{
    // Get the machine.config file applicabe to the
    // specified reosurce.
    System.Configuration.Configuration config =
        WebConfigurationManager.OpenMachineConfiguration("configTest");

    // 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);
}

' Show how to use OpenMachineConfiguration(string).
' It gets the machine.config file applicabe to the
' specified resource and displays section 
' basic information. 
Shared Sub OpenMachineConfiguration2()
    ' Get the machine.config file applicabe to the
    ' specified reosurce.
    Dim config As System.Configuration.Configuration = _
    WebConfigurationManager.OpenMachineConfiguration( _
    "configTest")

    ' 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

Keterangan

Metode ini membuka file konfigurasi komputer yang berlaku untuk direktori yang ditentukan oleh locationSubPath parameter .

Lihat juga

• Configuration

OpenMachineConfiguration(String, String)

Membuka file konfigurasi komputer yang ditentukan pada server yang ditentukan sebagai Configuration objek untuk mengizinkan operasi baca atau tulis.

public:
 static System::Configuration::Configuration ^ OpenMachineConfiguration(System::String ^ locationSubPath, System::String ^ server);

public static System.Configuration.Configuration OpenMachineConfiguration (string locationSubPath, string server);

static member OpenMachineConfiguration : string * string -> System.Configuration.Configuration

Public Shared Function OpenMachineConfiguration (locationSubPath As String, server As String) As Configuration

Parameter

locationSubPath

String

Jalur aplikasi tempat konfigurasi berlaku.

server

String

Nama server yang sepenuhnya memenuhi syarat untuk mengembalikan konfigurasi.

Mengembalikan

Configuration

Objek Configuration.

Pengecualian

ConfigurationErrorsException

File konfigurasi yang valid tidak dapat dimuat.

Contoh

Contoh berikut menunjukkan cara mengakses informasi konfigurasi dengan OpenMachineConfiguration metode .

// Show how to use OpenMachineConfiguration(string, string).
// It gets the machine.config file on the specified server and
// applicabe to the specified reosurce and displays section 
// basic information. 
static void OpenMachineConfiguration3()
{
    // Get the machine.config file applicabe to the
    // specified reosurce and on the specified server.
    System.Configuration.Configuration config =
        WebConfigurationManager.OpenMachineConfiguration("configTest", 
        "myServer");

    // 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);
}

' Show how to use OpenMachineConfiguration(string, string).
' It gets the machine.config file on the specified server and
' applicabe to the specified reosurce and displays section 
' basic information. 
Shared Sub OpenMachineConfiguration3()
    ' Get the machine.config file applicabe to the
    ' specified reosurce and on the specified server.
    Dim config As System.Configuration.Configuration = _
    WebConfigurationManager.OpenMachineConfiguration( _
    "configTest", "myServer")

    ' 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

Keterangan

Metode ini membuka file konfigurasi komputer yang terletak di direktori yang ditentukan oleh locationSubPath parameter dan pada komputer yang ditentukan oleh server parameter .

Lihat juga

• Configuration

OpenMachineConfiguration(String, String, IntPtr)

Membuka file konfigurasi komputer yang ditentukan pada server yang ditentukan sebagai Configuration objek, menggunakan konteks keamanan yang ditentukan untuk mengizinkan operasi baca atau tulis.

public:
 static System::Configuration::Configuration ^ OpenMachineConfiguration(System::String ^ locationSubPath, System::String ^ server, IntPtr userToken);

public static System.Configuration.Configuration OpenMachineConfiguration (string locationSubPath, string server, IntPtr userToken);

static member OpenMachineConfiguration : string * string * nativeint -> System.Configuration.Configuration

Public Shared Function OpenMachineConfiguration (locationSubPath As String, server As String, userToken As IntPtr) As Configuration

Parameter

locationSubPath

String

Jalur aplikasi tempat konfigurasi berlaku.

server

String

Nama server yang sepenuhnya memenuhi syarat untuk mengembalikan konfigurasi.

userToken

IntPtr

nativeint

Token akun yang akan digunakan.

Mengembalikan

Configuration

Objek Configuration.

Pengecualian

ArgumentException

Nilai yang valid tidak disediakan untuk server parameter atau userToken .

ConfigurationErrorsException

File konfigurasi yang valid tidak dapat dimuat.

Contoh

Contoh berikut menunjukkan cara mengakses informasi konfigurasi dengan OpenMachineConfiguration metode .

// Show how to use OpenMachineConfiguration(string, string).
// It gets the machine.config file on the specified server,
// applicabe to the specified reosurce, for the specified user
// and displays section basic information. 
static void OpenMachineConfiguration4()
{
    // Get the current user token.
    IntPtr userToken =
          System.Security.Principal.WindowsIdentity.GetCurrent().Token;

    // Get the machine.config file applicabe to the
    // specified reosurce, on the specified server for the
    // specified user.
    System.Configuration.Configuration config =
        WebConfigurationManager.OpenMachineConfiguration("configTest",
        "myServer", userToken);

    // 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);
}

' Show how to use OpenMachineConfiguration(string, string).
' It gets the machine.config file on the specified server,
' applicabe to the specified reosurce, for the specified user
' and displays section basic information. 
Shared Sub OpenMachineConfiguration4()
    ' Get the current user token.
    Dim userToken As IntPtr = _
    System.Security.Principal.WindowsIdentity.GetCurrent().Token

    ' Get the machine.config file applicabe to the
    ' specified reosurce, on the specified server for the
    ' specified user.
    Dim config As System.Configuration.Configuration = _
    WebConfigurationManager.OpenMachineConfiguration( _
    "configTest", "myServer", userToken)

    ' 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

Keterangan

Metode ini digunakan untuk mengakses file konfigurasi menggunakan peniruan identitas.

Catatan

Token akun biasanya diambil dari instans WindowsIdentity kelas atau melalui panggilan ke kode yang tidak dikelola, seperti panggilan ke Windows API LogonUser. Untuk informasi selengkapnya tentang panggilan ke kode yang tidak dikelola, lihat Mengonsumsi Fungsi DLL Yang Tidak Dikelola.

Lihat juga

• Configuration
• WindowsIdentity
• Memakai Fungsi DLL Tidak Terkelola

OpenMachineConfiguration(String, String, String, String)

Membuka file konfigurasi komputer yang ditentukan pada server yang ditentukan sebagai Configuration objek, menggunakan konteks keamanan yang ditentukan untuk mengizinkan operasi baca atau tulis.

public:
 static System::Configuration::Configuration ^ OpenMachineConfiguration(System::String ^ locationSubPath, System::String ^ server, System::String ^ userName, System::String ^ password);

public static System.Configuration.Configuration OpenMachineConfiguration (string locationSubPath, string server, string userName, string password);

static member OpenMachineConfiguration : string * string * string * string -> System.Configuration.Configuration

Public Shared Function OpenMachineConfiguration (locationSubPath As String, server As String, userName As String, password As String) As Configuration

Parameter

locationSubPath

String

Jalur aplikasi tempat konfigurasi berlaku.

server

String

Nama server yang sepenuhnya memenuhi syarat untuk mengembalikan konfigurasi.

userName

String

Nama pengguna lengkap (Domain\User) yang digunakan saat membuka file.

password

String

Kata sandi untuk nama pengguna.

Mengembalikan

Configuration

Objek Configuration.

Pengecualian

ArgumentException

Parameter server atau userName dan password tidak valid.

ConfigurationErrorsException

File konfigurasi yang valid tidak dapat dimuat.

Contoh

Contoh berikut menunjukkan cara mengakses informasi konfigurasi dengan OpenMachineConfiguration metode .

// Show how to use OpenMachineConfiguration(string, string).
// It gets the machine.config file on the specified server,
// applicabe to the specified reosurce, for the specified user
// and displays section basic information. 
static void OpenMachineConfiguration5()
{
    // Set the user id and password.
    string user =
          System.Security.Principal.WindowsIdentity.GetCurrent().Name;
    // Substitute with actual password.
    string password = "userPassword";

    // Get the machine.config file applicabe to the
    // specified reosurce, on the specified server for the
    // specified user.
    System.Configuration.Configuration config =
        WebConfigurationManager.OpenMachineConfiguration("configTest",
        "myServer", user, password);

    // 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);
}

 ' Show how to use OpenMachineConfiguration(string, string).
 ' It gets the machine.config file on the specified server,
 ' applicabe to the specified reosurce, for the specified user
 ' and displays section basic information. 
 Shared Sub OpenMachineConfiguration5()
     ' Set the user id and password.
     Dim user As String = _
     System.Security.Principal.WindowsIdentity.GetCurrent().Name
     ' Substitute with actual password.
     Dim password As String = "userPassword"

     ' Get the machine.config file applicabe to the
     ' specified reosurce, on the specified server for the
     ' specified user.
     Dim config As System.Configuration.Configuration = _
     WebConfigurationManager.OpenMachineConfiguration( _
     "configTest", "myServer", user, password)

     ' 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

Keterangan

Metode ini digunakan untuk mengakses file konfigurasi menggunakan peniruan identitas.

Lihat juga

• Configuration