WebConfigurationManager.OpenMachineConfiguration Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ö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.