WebConfigurationManager.OpenMachineConfiguration Método
Definición
Abre el archivo de configuración del equipo como un objeto Configuration para permitir operaciones de lectura o escritura.Opens the machine-configuration file as a Configuration object to allow read or write operations.
Sobrecargas
OpenMachineConfiguration() |
Abre el archivo de configuración del equipo en el equipo actual como un objeto Configuration para permitir las operaciones de lectura o escritura.Opens the machine-configuration file on the current computer as a Configuration object to allow read or write operations. |
OpenMachineConfiguration(String) |
Abre el archivo de configuración del equipo en el equipo actual como un objeto Configuration para permitir las operaciones de lectura o escritura.Opens the machine-configuration file on the current computer as a Configuration object to allow read or write operations. |
OpenMachineConfiguration(String, String) |
Abre el archivo de configuración del equipo en el servidor especificado como un objeto Configuration para permitir operaciones de lectura o escritura.Opens the specified machine-configuration file on the specified server as a Configuration object to allow read or write operations. |
OpenMachineConfiguration(String, String, IntPtr) |
Abre el archivo de configuración del equipo especificado en el servidor especificado como un objeto Configuration, utilizando el contexto de seguridad definido para permitir operaciones de lectura o escritura.Opens the specified machine-configuration file on the specified server as a Configuration object, using the specified security context to allow read or write operations. |
OpenMachineConfiguration(String, String, String, String) |
Abre el archivo de configuración del equipo especificado en el servidor especificado como un objeto Configuration, utilizando el contexto de seguridad definido para permitir operaciones de lectura o escritura.Opens the specified machine-configuration file on the specified server as a Configuration object, using the specified security context to allow read or write operations. |
OpenMachineConfiguration()
Abre el archivo de configuración del equipo en el equipo actual como un objeto Configuration para permitir las operaciones de lectura o escritura.Opens the machine-configuration file on the current computer as a Configuration object to allow read or write operations.
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
Devoluciones
Objeto Configuration.A Configuration object.
Excepciones
No se pudo cargar un archivo de configuración válido.A valid configuration file could not be loaded.
Ejemplos
En el ejemplo siguiente se muestra cómo obtener acceso a la información de configuración con el OpenMachineConfiguration método.The following example shows how to access configuration information with the OpenMachineConfiguration method.
// 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
Comentarios
El OpenMachineConfiguration método abre el archivo de configuración de equipo en el equipo donde se ejecuta la aplicación.The OpenMachineConfiguration method opens the machine-configuration file on the computer where the application runs. Este archivo se encuentra en el directorio de compilación estándar%windir%\Microsoft.NET\Framework\version\config.This file is located in the standard build directory %windir%\Microsoft.NET\Framework\version\config.
Consulte también
Se aplica a
OpenMachineConfiguration(String)
Abre el archivo de configuración del equipo en el equipo actual como un objeto Configuration para permitir las operaciones de lectura o escritura.Opens the machine-configuration file on the current computer as a Configuration object to allow read or write operations.
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
Parámetros
- locationSubPath
- String
Ruta de acceso de la aplicación a la que se aplica la configuración del equipo.The application path to which the machine configuration applies.
Devoluciones
Objeto Configuration.A Configuration object.
Excepciones
No se pudo cargar un archivo de configuración válido.A valid configuration file could not be loaded.
Ejemplos
En el ejemplo siguiente se muestra cómo obtener acceso a la información de configuración con el OpenMachineConfiguration método.The following example shows how to access configuration information with the OpenMachineConfiguration method.
// 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
Comentarios
Este método abre el archivo de configuración del equipo que se aplica al directorio especificado por el locationSubPath
parámetro.This method opens the machine-configuration file that is applicable to the directory specified by the locationSubPath
parameter.
Consulte también
Se aplica a
OpenMachineConfiguration(String, String)
Abre el archivo de configuración del equipo en el servidor especificado como un objeto Configuration para permitir operaciones de lectura o escritura.Opens the specified machine-configuration file on the specified server as a Configuration object to allow read or write operations.
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
Parámetros
- locationSubPath
- String
Ruta de acceso de la aplicación a la que se aplica la configuración.The application path to which the configuration applies.
- server
- String
Nombre completo del servidor para el que se devuelve la configuración.The fully qualified name of the server to return the configuration for.
Devoluciones
Objeto Configuration.A Configuration object.
Excepciones
No se pudo cargar un archivo de configuración válido.A valid configuration file could not be loaded.
Ejemplos
En el ejemplo siguiente se muestra cómo obtener acceso a la información de configuración con el OpenMachineConfiguration método.The following example shows how to access configuration information with the OpenMachineConfiguration method.
// 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
Comentarios
Este método abre el archivo de configuración del equipo que se encuentra en el directorio especificado por el locationSubPath
parámetro y en el equipo especificado por el server
parámetro.This method opens the machine-configuration file that is located in the directory specified by the locationSubPath
parameter and on the computer specified by the server
parameter.
Consulte también
Se aplica a
OpenMachineConfiguration(String, String, IntPtr)
Abre el archivo de configuración del equipo especificado en el servidor especificado como un objeto Configuration, utilizando el contexto de seguridad definido para permitir operaciones de lectura o escritura.Opens the specified machine-configuration file on the specified server as a Configuration object, using the specified security context to allow read or write operations.
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
Parámetros
- locationSubPath
- String
Ruta de acceso de la aplicación a la que se aplica la configuración.The application path to which the configuration applies.
- server
- String
Nombre completo del servidor para el que se devuelve la configuración.The fully qualified name of the server to return the configuration for.
- userToken
- IntPtr
Símbolo (token) de la cuenta que se utilizará.An account token to use.
Devoluciones
Objeto Configuration.A Configuration object.
Excepciones
Los valores válidos no se proporcionaron para los parámetros server
o userToken
.Valid values were not supplied for the server
or userToken
parameters.
No se pudo cargar un archivo de configuración válido.A valid configuration file could not be loaded.
Ejemplos
En el ejemplo siguiente se muestra cómo obtener acceso a la información de configuración con el OpenMachineConfiguration método.The following example shows how to access configuration information with the OpenMachineConfiguration method.
// 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
Comentarios
Este método se usa para tener acceso a un archivo de configuración mediante la suplantación.This method is used to access a configuration file using impersonation.
Nota
El token de cuenta se recupera normalmente de una instancia de la WindowsIdentity clase o a través de una llamada a código no administrado, como una llamada a la API de Windows LogonUser
.The account token is usually retrieved from an instance of the WindowsIdentity class or through a call to unmanaged code, such as a call to the Windows API LogonUser
. Para obtener más información sobre las llamadas a código no administrado, vea consumir funciones dll no administradas.For more information about calls to unmanaged code, see Consuming Unmanaged DLL Functions.
Consulte también
- Configuration
- WindowsIdentity
- Consumir funciones DLL no administradasConsuming Unmanaged DLL Functions
Se aplica a
OpenMachineConfiguration(String, String, String, String)
Abre el archivo de configuración del equipo especificado en el servidor especificado como un objeto Configuration, utilizando el contexto de seguridad definido para permitir operaciones de lectura o escritura.Opens the specified machine-configuration file on the specified server as a Configuration object, using the specified security context to allow read or write operations.
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
Parámetros
- locationSubPath
- String
Ruta de acceso de la aplicación a la que se aplica la configuración.The application path to which the configuration applies.
- server
- String
Nombre completo del servidor para el que se devuelve la configuración.The fully qualified name of the server to return the configuration for.
- userName
- String
Nombre de usuario completo (Domain\User) que se utilizará al abrir el archivo.The full user name (Domain\User) to use when opening the file.
- password
- String
Contraseña del nombre de usuario.The password for the user name.
Devoluciones
Objeto Configuration.A Configuration object.
Excepciones
Los parámetros server
o userName
y password
no eran válidos.The server
or userName
and password
parameters were invalid.
No se pudo cargar un archivo de configuración válido.A valid configuration file could not be loaded.
Ejemplos
En el ejemplo siguiente se muestra cómo obtener acceso a la información de configuración con el OpenMachineConfiguration método.The following example shows how to access configuration information with the OpenMachineConfiguration method.
// 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
Comentarios
Este método se usa para tener acceso a un archivo de configuración mediante la suplantación.This method is used to access a configuration file using impersonation.