WebConfigurationManager.OpenMachineConfiguration Methode

Definition

Öffnet die Computerkonfigurationsdatei als Configuration Objekt, um Lese- oder Schreibvorgänge zuzulassen.

Überlädt

Name Beschreibung
OpenMachineConfiguration()

Öffnet die Computerkonfigurationsdatei auf dem aktuellen Computer als Configuration Objekt, um Lese- oder Schreibvorgänge zuzulassen.

OpenMachineConfiguration(String)

Öffnet die Computerkonfigurationsdatei auf dem aktuellen Computer als Configuration Objekt, um Lese- oder Schreibvorgänge zuzulassen.

OpenMachineConfiguration(String, String)

Öffnet die angegebene Computerkonfigurationsdatei auf dem angegebenen Server als Configuration Objekt, um Lese- oder Schreibvorgänge zuzulassen.

OpenMachineConfiguration(String, String, IntPtr)

Öffnet die angegebene Computerkonfigurationsdatei auf dem angegebenen Server als Configuration Objekt, wobei der angegebene Sicherheitskontext verwendet wird, um Lese- oder Schreibvorgänge zuzulassen.

OpenMachineConfiguration(String, String, String, String)

Öffnet die angegebene Computerkonfigurationsdatei auf dem angegebenen Server als Configuration Objekt, wobei der angegebene Sicherheitskontext verwendet wird, um Lese- oder Schreibvorgänge zuzulassen.

OpenMachineConfiguration()

Öffnet die Computerkonfigurationsdatei auf dem aktuellen Computer als Configuration Objekt, um Lese- oder Schreibvorgänge zuzulassen.

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

Gibt zurück

Ein Configuration-Objekt.

Ausnahmen

Eine gültige Konfigurationsdatei konnte nicht geladen werden.

Beispiele

Das folgende Beispiel zeigt, wie Sie mit der OpenMachineConfiguration Methode auf Konfigurationsinformationen zugreifen.


// 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

Hinweise

Die OpenMachineConfiguration Methode öffnet die Computerkonfigurationsdatei auf dem Computer, auf dem die Anwendung ausgeführt wird. Diese Datei befindet sich im Standardbuildverzeichnis %windir%\Microsoft.NET\Framework\version\config.

Weitere Informationen

Gilt für:

OpenMachineConfiguration(String)

Öffnet die Computerkonfigurationsdatei auf dem aktuellen Computer als Configuration Objekt, um Lese- oder Schreibvorgänge zuzulassen.

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

Der Anwendungspfad, auf den die Computerkonfiguration angewendet wird.

Gibt zurück

Ein Configuration-Objekt.

Ausnahmen

Eine gültige Konfigurationsdatei konnte nicht geladen werden.

Beispiele

Das folgende Beispiel zeigt, wie Sie mit der OpenMachineConfiguration Methode auf Konfigurationsinformationen zugreifen.


// Show how to use OpenMachineConfiguration(string).
// It gets the machine.config file applicable to the
// specified resource and displays section
// basic information.
static void OpenMachineConfiguration2()
{
    // Get the machine.config file applicable to the
    // specified resource.
    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

Hinweise

Diese Methode öffnet die Computerkonfigurationsdatei, die für das durch den locationSubPath Parameter angegebene Verzeichnis anwendbar ist.

Weitere Informationen

Gilt für:

OpenMachineConfiguration(String, String)

Öffnet die angegebene Computerkonfigurationsdatei auf dem angegebenen Server als Configuration Objekt, um Lese- oder Schreibvorgänge zuzulassen.

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

Der Anwendungspfad, auf den die Konfiguration angewendet wird.

server
String

Der vollqualifizierte Name des Servers, für den die Konfiguration zurückgegeben werden soll.

Gibt zurück

Ein Configuration-Objekt.

Ausnahmen

Eine gültige Konfigurationsdatei konnte nicht geladen werden.

Beispiele

Das folgende Beispiel zeigt, wie Sie mit der OpenMachineConfiguration Methode auf Konfigurationsinformationen zugreifen.


// Show how to use OpenMachineConfiguration(string, string).
// It gets the machine.config file on the specified server and
// applicable to the specified resource and displays section
// basic information.
static void OpenMachineConfiguration3()
{
    // Get the machine.config file applicable to the
    // specified resource 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

Hinweise

Mit dieser Methode wird die Computerkonfigurationsdatei geöffnet, die sich im verzeichnis befindet, das durch den locationSubPath Parameter und auf dem durch den server Parameter angegebenen Computer angegeben ist.

Weitere Informationen

Gilt für:

OpenMachineConfiguration(String, String, IntPtr)

Öffnet die angegebene Computerkonfigurationsdatei auf dem angegebenen Server als Configuration Objekt, wobei der angegebene Sicherheitskontext verwendet wird, um Lese- oder Schreibvorgänge zuzulassen.

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

Der Anwendungspfad, auf den die Konfiguration angewendet wird.

server
String

Der vollqualifizierte Name des Servers, für den die Konfiguration zurückgegeben werden soll.

userToken
IntPtr

nativeint

Ein zu verwendenes Kontotoken.

Gibt zurück

Ein Configuration-Objekt.

Ausnahmen

Gültige Werte wurden für die Parameter oder server parameter userToken nicht angegeben.

Eine gültige Konfigurationsdatei konnte nicht geladen werden.

Beispiele

Das folgende Beispiel zeigt, wie Sie mit der OpenMachineConfiguration Methode auf Konfigurationsinformationen zugreifen.


// Show how to use OpenMachineConfiguration(string, string).
// It gets the machine.config file on the specified server,
// applicable to the specified resource, 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 applicable to the
    // specified resource, 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

Hinweise

Diese Methode wird verwendet, um mithilfe des Identitätswechsels auf eine Konfigurationsdatei zuzugreifen.

Note

Das Kontotoken wird in der Regel aus einer Instanz der klasse WindowsIdentity oder über einen Aufruf von nicht verwaltetem Code abgerufen, z. B. durch einen Aufruf der Windows-API LogonUser. Weitere Informationen zu Aufrufen von nicht verwalteten Code finden Sie unter Verwenden nicht verwalteter DLL-Funktionen.

Weitere Informationen

Gilt für:

OpenMachineConfiguration(String, String, String, String)

Öffnet die angegebene Computerkonfigurationsdatei auf dem angegebenen Server als Configuration Objekt, wobei der angegebene Sicherheitskontext verwendet wird, um Lese- oder Schreibvorgänge zuzulassen.

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

Der Anwendungspfad, auf den die Konfiguration angewendet wird.

server
String

Der vollqualifizierte Name des Servers, für den die Konfiguration zurückgegeben werden soll.

userName
String

Der vollständige Benutzername (Domäne\Benutzer), der beim Öffnen der Datei verwendet werden soll.

password
String

Das Kennwort für den Benutzernamen.

Gibt zurück

Ein Configuration-Objekt.

Ausnahmen

Die server Parameter oder Parameter userNamepassword waren ungültig.

Eine gültige Konfigurationsdatei konnte nicht geladen werden.

Beispiele

Das folgende Beispiel zeigt, wie Sie mit der OpenMachineConfiguration Methode auf Konfigurationsinformationen zugreifen.


// Show how to use OpenMachineConfiguration(string, string).
// It gets the machine.config file on the specified server,
// applicable to the specified resource, 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 applicable to the
    // specified resource, 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

Hinweise

Diese Methode wird verwendet, um mithilfe des Identitätswechsels auf eine Konfigurationsdatei zuzugreifen.

Weitere Informationen

Gilt für: