WebConfigurationManager.OpenMachineConfiguration Método
Definição
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
Um objeto Configuration.
Exceções
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
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
Um objeto Configuration.
Exceções
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
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
Um objeto Configuration.
Exceções
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
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
Um objeto Configuration.
Exceções
Não foram fornecidos valores válidos para os parâmetros server
ou userToken
.
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 LogonUser
Windows . 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
Um objeto Configuration.
Exceções
Os parâmetros server
ou userName
e password
eram inválidos.
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.