WebConfigurationManager.OpenMachineConfiguration Método

Definición

Abre el archivo de configuración de máquina como un Configuration objeto para permitir operaciones de lectura o escritura.

Sobrecargas

Nombre Description
OpenMachineConfiguration()

Abre el archivo de configuración de máquina en el equipo actual como un Configuration objeto para permitir operaciones de lectura o escritura.

OpenMachineConfiguration(String)

Abre el archivo de configuración de máquina en el equipo actual como un Configuration objeto para permitir operaciones de lectura o escritura.

OpenMachineConfiguration(String, String)

Abre el archivo de configuración de máquina especificado en el servidor especificado como un Configuration objeto para permitir operaciones de lectura o escritura.

OpenMachineConfiguration(String, String, IntPtr)

Abre el archivo de configuración de máquina especificado en el servidor especificado como un Configuration objeto, utilizando el contexto de seguridad especificado para permitir operaciones de lectura o escritura.

OpenMachineConfiguration(String, String, String, String)

Abre el archivo de configuración de máquina especificado en el servidor especificado como un Configuration objeto, utilizando el contexto de seguridad especificado para permitir operaciones de lectura o escritura.

OpenMachineConfiguration()

Abre el archivo de configuración de máquina en el equipo actual como un Configuration objeto para permitir operaciones de lectura o escritura.

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

Un objeto Configuration.

Excepciones

No se pudo cargar un archivo de configuración válido.

Ejemplos

En el ejemplo siguiente se muestra cómo acceder a la información de configuración con el OpenMachineConfiguration método .


// 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 máquina en el equipo donde se ejecuta la aplicación. Este archivo se encuentra en el directorio de compilación estándar %windir%\Microsoft.NET\Framework\version\config.

Consulte también

Se aplica a

OpenMachineConfiguration(String)

Abre el archivo de configuración de máquina en el equipo actual como un Configuration objeto para permitir operaciones de lectura o escritura.

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 de la máquina.

Devoluciones

Un objeto Configuration.

Excepciones

No se pudo cargar un archivo de configuración válido.

Ejemplos

En el ejemplo siguiente se muestra cómo acceder a la información de configuración con el OpenMachineConfiguration método .


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

Comentarios

Este método abre el archivo de configuración de máquina que es aplicable al directorio especificado por el locationSubPath parámetro .

Consulte también

Se aplica a

OpenMachineConfiguration(String, String)

Abre el archivo de configuración de máquina especificado en el servidor especificado como un Configuration objeto para permitir operaciones de lectura o escritura.

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.

server
String

Nombre completo del servidor para el que se va a devolver la configuración.

Devoluciones

Un objeto Configuration.

Excepciones

No se pudo cargar un archivo de configuración válido.

Ejemplos

En el ejemplo siguiente se muestra cómo acceder a la información de configuración con el OpenMachineConfiguration método .


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

Comentarios

Este método abre el archivo de configuración de máquina que se encuentra en el directorio especificado por el locationSubPath parámetro y en el equipo especificado por el server parámetro .

Consulte también

Se aplica a

OpenMachineConfiguration(String, String, IntPtr)

Abre el archivo de configuración de máquina especificado en el servidor especificado como un Configuration objeto, utilizando el contexto de seguridad especificado para permitir operaciones de lectura o escritura.

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.

server
String

Nombre completo del servidor para el que se va a devolver la configuración.

userToken
IntPtr

nativeint

Token de cuenta que se va a usar.

Devoluciones

Un objeto Configuration.

Excepciones

No se proporcionaron valores válidos para los server parámetros o userToken .

No se pudo cargar un archivo de configuración válido.

Ejemplos

En el ejemplo siguiente se muestra cómo acceder a la información de configuración con el OpenMachineConfiguration método .


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

Comentarios

Este método se usa para acceder a un archivo de configuración mediante la suplantación.

Note

Normalmente, el token de cuenta se recupera de una instancia de la clase /> . Para obtener más información sobre las llamadas al código no administrado, consulte Consumo de funciones DLL no administradas.

Consulte también

Se aplica a

OpenMachineConfiguration(String, String, String, String)

Abre el archivo de configuración de máquina especificado en el servidor especificado como un Configuration objeto, utilizando el contexto de seguridad especificado para permitir operaciones de lectura o escritura.

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.

server
String

Nombre completo del servidor para el que se va a devolver la configuración.

userName
String

Nombre de usuario completo (Dominio\Usuario) que se va a usar al abrir el archivo.

password
String

Contraseña del nombre de usuario.

Devoluciones

Un objeto Configuration.

Excepciones

Los server parámetros o y userNamepassword no eran válidos.

No se pudo cargar un archivo de configuración válido.

Ejemplos

En el ejemplo siguiente se muestra cómo acceder a la información de configuración con el OpenMachineConfiguration método .


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

Comentarios

Este método se usa para acceder a un archivo de configuración mediante la suplantación.

Consulte también

Se aplica a