WebConfigurationManager.OpenMachineConfiguration Método

Referência

Definição

Namespace:: System.Web.Configuration

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Abre o arquivo de configuração de computador como um objeto Configuration para permitir operações de leitura ou gravação.

Sobrecargas

OpenMachineConfiguration()	Abre o arquivo de configuração de computador no computador atual como um objeto Configuration para permitir a leitura ou gravação.
OpenMachineConfiguration(String)	Abre o arquivo de configuração de computador no computador atual como um objeto Configuration para permitir a leitura ou gravação.
OpenMachineConfiguration(String, String)	Abre o arquivo de configuração de computador no servidor especificado como um objeto Configuration para permitir operações de leitura ou gravação.
OpenMachineConfiguration(String, String, IntPtr)	Abre o arquivo de configuração de computador indicado no servidor especificado como um objeto Configuration usando o contexto de segurança para permitir operações de leitura ou gravação.
OpenMachineConfiguration(String, String, String, String)	Abre o arquivo de configuração de computador indicado no servidor especificado como um objeto Configuration usando o contexto de segurança para permitir operações de leitura ou gravação.

OpenMachineConfiguration()

Abre o arquivo de configuração de computador no computador atual como um objeto Configuration para permitir a leitura ou gravação.

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

Retornos

Configuration

Um objeto Configuration.

Exceções

ConfigurationErrorsException

Não foi possível carregar um arquivo de configuração válido.

Exemplos

O exemplo a seguir mostra como acessar informações de configuração com o 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

Comentários

O OpenMachineConfiguration método abre o arquivo de configuração do computador no computador em que o aplicativo é executado. Esse arquivo está localizado no diretório de build padrão %windir%\Microsoft.NET\Framework\version\config.

Confira também

Configuration

Aplica-se a

OpenMachineConfiguration(String)

Abre o arquivo de configuração de computador no computador atual como um objeto Configuration para permitir a leitura ou gravação.

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

O caminho do aplicativo ao qual a configuração do computador se aplica.

Retornos

Configuration

Um objeto Configuration.

Exceções

ConfigurationErrorsException

Não foi possível carregar um arquivo de configuração válido.

Exemplos

O exemplo a seguir mostra como acessar informações de configuração com o OpenMachineConfiguration método.


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

Comentários

Esse método abre o arquivo de configuração do computador aplicável ao diretório especificado pelo locationSubPath parâmetro.

Confira também

Configuration

Aplica-se a

OpenMachineConfiguration(String, String)

Abre o arquivo de configuração de computador no servidor especificado como um objeto Configuration para permitir operações de leitura ou gravação.

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

O caminho do aplicativo ao qual a configuração se aplica.

server: String

O nome totalmente qualificado do servidor para o qual a configuração será retornada.

Retornos

Configuration

Um objeto Configuration.

Exceções

ConfigurationErrorsException

Não foi possível carregar um arquivo de configuração válido.

Exemplos

O exemplo a seguir mostra como acessar informações de configuração com o OpenMachineConfiguration método.


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

Comentários

Esse método abre o arquivo de configuração do computador localizado no diretório especificado pelo locationSubPath parâmetro e no computador especificado pelo server parâmetro.

Confira também

Configuration

Aplica-se a

OpenMachineConfiguration(String, String, IntPtr)

Abre o arquivo de configuração de computador indicado no servidor especificado como um objeto Configuration usando o contexto de segurança para permitir operações de leitura ou gravação.

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

O caminho do aplicativo ao qual a configuração se aplica.

server: String

O nome totalmente qualificado do servidor para o qual a configuração será retornada.

userToken: IntPtr
nativeint

Um token de conta a ser usado.

Retornos

Configuration

Um objeto Configuration.

Exceções

ArgumentException

Não foram fornecidos valores válidos para os parâmetros server ou userToken.

ConfigurationErrorsException

Não foi possível carregar um arquivo de configuração válido.

Exemplos

O exemplo a seguir mostra como acessar informações de configuração com o OpenMachineConfiguration método.


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

Comentários

Esse método é usado para acessar um arquivo de configuração usando representação.

Observação

O token de conta geralmente é recuperado de uma instância da WindowsIdentity classe ou por meio de uma chamada para código não gerenciado, como uma chamada para a API LogonUserWindows . Para obter mais informações sobre chamadas para código não gerenciado, consulte Consumindo funções de DLL não gerenciadas.

Confira também

Aplica-se a

OpenMachineConfiguration(String, String, String, String)

Abre o arquivo de configuração de computador indicado no servidor especificado como um objeto Configuration usando o contexto de segurança para permitir operações de leitura ou gravação.

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

O caminho do aplicativo ao qual a configuração se aplica.

server: String

O nome totalmente qualificado do servidor para o qual a configuração será retornada.

userName: String

O nome de usuário completo (Domínio\Usuário) a ser usado ao abrir o arquivo.

password: String

A senha do nome de usuário.

Retornos

Configuration

Um objeto Configuration.

Exceções

ArgumentException

Os parâmetros server ou userName e password eram inválidos.

ConfigurationErrorsException

Não foi possível carregar um arquivo de configuração válido.

Exemplos

O exemplo a seguir mostra como acessar informações de configuração com o OpenMachineConfiguration método.


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

Comentários

Esse método é usado para acessar um arquivo de configuração usando representação.

Confira também

Configuration

Aplica-se a

Compartilhar via

WebConfigurationManager.OpenMachineConfiguration Método

Definição

Sobrecargas

OpenMachineConfiguration()

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

OpenMachineConfiguration(String)

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

OpenMachineConfiguration(String, String)

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

OpenMachineConfiguration(String, String, IntPtr)

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

OpenMachineConfiguration(String, String, String, String)

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

Recursos adicionais