WebConfigurationManager.OpenWebConfiguration 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 aplicativo Web como um objeto Configuration.

Sobrecargas

OpenWebConfiguration(String)	Abre o arquivo de configuração de aplicativo Web como um objeto Configuration usando o caminho virtual especificado para permitir operações de leitura ou gravação.
OpenWebConfiguration(String, String)	Abre o arquivo de configuração de aplicativo Web como um objeto Configuration usando o nome do site e o caminho virtual especificados para permitir operações de leitura ou gravação.
OpenWebConfiguration(String, String, String)	Abre o arquivo de configuração de aplicativo Web como um objeto Configuration usando o caminho virtual, o nome do site e a localização especificados para permitir operações de leitura ou gravação.
OpenWebConfiguration(String, String, String, String)	Abre o arquivo de configuração de aplicativo Web como um objeto Configuration usando o caminho virtual, o nome do site, a localização e o servidor especificados para permitir operações de leitura ou gravação.
OpenWebConfiguration(String, String, String, String, IntPtr)	Abre o arquivo de configuração de aplicativo Web como um objeto Configuration usando o caminho virtual, nome do site, local, servidor e contexto de segurança especificados para permitir operações de leitura ou gravação.
OpenWebConfiguration(String, String, String, String, String, String)	Abre o arquivo de configuração de aplicativo Web como um objeto Configuration usando o caminho virtual, nome do site, local, servidor e contexto de segurança especificados para permitir operações de leitura ou gravação.

OpenWebConfiguration(String)

Abre o arquivo de configuração de aplicativo Web como um objeto Configuration usando o caminho virtual especificado para permitir operações de leitura ou gravação.

public:
 static System::Configuration::Configuration ^ OpenWebConfiguration(System::String ^ path);

public static System.Configuration.Configuration OpenWebConfiguration (string path);

static member OpenWebConfiguration : string -> System.Configuration.Configuration

Public Shared Function OpenWebConfiguration (path As String) As Configuration

Parâmetros

path: String

O caminho virtual para o arquivo de configuração. Se for null, o arquivo Web.config raiz será aberto.

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 OpenWebConfiguration método.


// Show how to use OpenWebConfiguration(string).
// It gets he appSettings section of a Web application 
// runnig on the local server. 
static void OpenWebConfiguration1()
{
    // Get the configuration object for a Web application
    // running on the local server. 
    System.Configuration.Configuration config =
        WebConfigurationManager.OpenWebConfiguration("/configTest") 
        as System.Configuration.Configuration; 

    // Get the appSettings.
    KeyValueConfigurationCollection appSettings =
         config.AppSettings.Settings;

    // Loop through the collection and
    // display the appSettings key, value pairs.
    Console.WriteLine("[appSettings for app at: {0}]", "/configTest");
    foreach (string key in appSettings.AllKeys)
    {
        Console.WriteLine("Name: {0} Value: {1}",
        key, appSettings[key].Value);
    }

    Console.WriteLine();
}

' Show how to use OpenWebConfiguration(string).
' It gets he appSettings section of a Web application 
' runnig on the local server. 
Shared Sub OpenWebConfiguration1()
   ' Get the configuration object for a Web application
   ' running on the local server. 
     Dim config As System.Configuration.Configuration = _
     WebConfigurationManager.OpenWebConfiguration("/configTest")
   
   ' Get the appSettings.
     Dim appSettings As KeyValueConfigurationCollection = _
     config.AppSettings.Settings
   
   
   ' Loop through the collection and
   ' display the appSettings key, value pairs.
   Console.WriteLine("[appSettings for app at: {0}]", "/configTest")
   Dim key As String
   For Each key In  appSettings.AllKeys
         Console.WriteLine("Name: {0} Value: {1}", _
         key, appSettings(key).Value)
   Next key
   
   Console.WriteLine()
End Sub

Comentários

Para obter o Configuration objeto de um recurso, seu código deve ter privilégios de leitura em todos os arquivos de configuração dos quais herda as configurações. Para atualizar um arquivo de configuração, seu código também deve ter privilégios de gravação para o arquivo de configuração e o diretório no qual ele existe.

Confira também

Configuration

Aplica-se a

OpenWebConfiguration(String, String)

Abre o arquivo de configuração de aplicativo Web como um objeto Configuration usando o nome do site e o caminho virtual especificados para permitir operações de leitura ou gravação.

public:
 static System::Configuration::Configuration ^ OpenWebConfiguration(System::String ^ path, System::String ^ site);

public static System.Configuration.Configuration OpenWebConfiguration (string path, string site);

static member OpenWebConfiguration : string * string -> System.Configuration.Configuration

Public Shared Function OpenWebConfiguration (path As String, site As String) As Configuration

Parâmetros

path: String

O caminho virtual para o arquivo de configuração.

site: String

O nome do site do aplicativo, conforme exibido na configuração do IIS (Serviços de Informações da Internet).

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 OpenWebConfiguration método.


// Show how to use OpenWebConfiguration(string, string).
// It gets he appSettings section of a Web application 
// runnig on the local server. 
static void OpenWebConfiguration2()
{
    // Get the configuration object for a Web application
    // running on the local server. 
    System.Configuration.Configuration config =
        WebConfigurationManager.OpenWebConfiguration("/configTest", 
        "Default Web Site")
        as System.Configuration.Configuration;

    // Get the appSettings.
    KeyValueConfigurationCollection appSettings =
         config.AppSettings.Settings;

    // Loop through the collection and
    // display the appSettings key, value pairs.
    Console.WriteLine(
        "[appSettings for app at: /configTest");
    Console.WriteLine(" and site: Default Web Site]");

    foreach (string key in appSettings.AllKeys)
    {
        Console.WriteLine("Name: {0} Value: {1}",
        key, appSettings[key].Value);
    }

    Console.WriteLine();
}

' Show how to use OpenWebConfiguration(string, string).
' It gets he appSettings section of a Web application 
' runnig on the local server. 
Shared Sub OpenWebConfiguration2()
   ' Get the configuration object for a Web application
   ' running on the local server. 
     Dim config As System.Configuration.Configuration = _
     WebConfigurationManager.OpenWebConfiguration( _
     "/configTest", "Default Web Site")
   
   ' Get the appSettings.
     Dim appSettings As KeyValueConfigurationCollection = _
     config.AppSettings.Settings
   
   
   ' Loop through the collection and
   ' display the appSettings key, value pairs.
   Console.WriteLine("[appSettings for app at: /configTest")
   Console.WriteLine(" and site: Default Web Site]")
   
   Dim key As String
   For Each key In  appSettings.AllKeys
         Console.WriteLine("Name: {0} Value: {1}", _
         key, appSettings(key).Value)
   Next key
   
   Console.WriteLine()
End Sub

Comentários

Para obter o Configuration objeto de um recurso, seu código deve ter privilégios de leitura em todos os arquivos de configuração dos quais ele herda as configurações. Para atualizar um arquivo de configuração, seu código também deve ter privilégios de gravação para o arquivo de configuração e o diretório no qual ele existe.

Confira também

Configuration

Aplica-se a

OpenWebConfiguration(String, String, String)

Abre o arquivo de configuração de aplicativo Web como um objeto Configuration usando o caminho virtual, o nome do site e a localização especificados para permitir operações de leitura ou gravação.

public:
 static System::Configuration::Configuration ^ OpenWebConfiguration(System::String ^ path, System::String ^ site, System::String ^ locationSubPath);

public static System.Configuration.Configuration OpenWebConfiguration (string path, string site, string locationSubPath);

static member OpenWebConfiguration : string * string * string -> System.Configuration.Configuration

Public Shared Function OpenWebConfiguration (path As String, site As String, locationSubPath As String) As Configuration

Parâmetros

path: String

O caminho virtual para o arquivo de configuração.

site: String

O nome do site do aplicativo, conforme exibido na configuração do IIS (Serviços de Informações da Internet).

locationSubPath: String

O recurso específico ao qual a configuração 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 OpenWebConfiguration método.


// Show how to use OpenWebConfiguration(string, string, string).
// It gets he appSettings section of a Web application 
// runnig on the local server. 
static void OpenWebConfiguration3()
{
    // Get the configuration object for a Web application
    // running on the local server. 
    System.Configuration.Configuration config =
        WebConfigurationManager.OpenWebConfiguration(
        "/configTest", "Default Web Site", null)
        as System.Configuration.Configuration;

    // Get the appSettings.
    KeyValueConfigurationCollection appSettings =
         config.AppSettings.Settings;

    // Loop through the collection and
    // display the appSettings key, value pairs.
    Console.WriteLine(
        "[appSettings for app at: /configTest");
    Console.WriteLine(" site: Default Web Site");
    Console.WriteLine(" and locationSubPath: null]");
    
    foreach (string key in appSettings.AllKeys)
    {
        Console.WriteLine("Name: {0} Value: {1}",
        key, appSettings[key].Value);
    }

    Console.WriteLine();
}

' Show how to use OpenWebConfiguration(string, string, string).
' It gets he appSettings section of a Web application 
' runnig on the local server. 
Shared Sub OpenWebConfiguration3()
   ' Get the configuration object for a Web application
   ' running on the local server. 
     Dim config As System.Configuration.Configuration = _
     WebConfigurationManager.OpenWebConfiguration( _
     "/configTest", "Default Web Site", Nothing)
   
   ' Get the appSettings.
     Dim appSettings As KeyValueConfigurationCollection = _
     config.AppSettings.Settings
   
   ' Loop through the collection and
   ' display the appSettings key, value pairs.
   Console.WriteLine("[appSettings for app at: /configTest")
   Console.WriteLine(" site: Default Web Site")
   Console.WriteLine(" and locationSubPath: null]")
   
   Dim key As String
   For Each key In  appSettings.AllKeys
         Console.WriteLine("Name: {0} Value: {1}", _
         key, appSettings(key).Value)
   Next key
   
   Console.WriteLine()
End Sub

Comentários

Confira também

Configuration

Aplica-se a

OpenWebConfiguration(String, String, String, String)

Abre o arquivo de configuração de aplicativo Web como um objeto Configuration usando o caminho virtual, o nome do site, a localização e o servidor especificados para permitir operações de leitura ou gravação.

public:
 static System::Configuration::Configuration ^ OpenWebConfiguration(System::String ^ path, System::String ^ site, System::String ^ locationSubPath, System::String ^ server);

public static System.Configuration.Configuration OpenWebConfiguration (string path, string site, string locationSubPath, string server);

static member OpenWebConfiguration : string * string * string * string -> System.Configuration.Configuration

Public Shared Function OpenWebConfiguration (path As String, site As String, locationSubPath As String, server As String) As Configuration

Parâmetros

path: String

O caminho virtual para o arquivo de configuração.

site: String

O nome do site do aplicativo, conforme exibido na configuração do IIS (Serviços de Informações da Internet).

locationSubPath: String

O recurso específico ao qual a configuração se aplica.

server: String

O nome de rede do servidor no qual o aplicativo Web reside.

Retornos

Configuration

Um objeto Configuration.

Exceções

ArgumentException

O parâmetro do servidor era inválido.

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 OpenWebConfiguration método.


// Show how to use OpenWebConfiguration(string, string, 
// string, string).
// It gets he appSettings section of a Web application 
// running on the specified server. 
// If the server is remote your application must have the
// required access rights to the configuration file. 
static void OpenWebConfiguration4()
{
    // Get the configuration object for a Web application
    // running on the specified server.
    // Null for the subPath signifies no subdir. 
    System.Configuration.Configuration config =
           WebConfigurationManager.OpenWebConfiguration(
            "/configTest", "Default Web Site", null, "myServer")
           as System.Configuration.Configuration;
    
    // Get the appSettings.
    KeyValueConfigurationCollection appSettings =
         config.AppSettings.Settings;

    // Loop through the collection and
    // display the appSettings key, value pairs.
    Console.WriteLine("[appSettings for Web app on server: myServer]");
    foreach (string key in appSettings.AllKeys)
    {
        Console.WriteLine("Name: {0} Value: {1}",
        key, appSettings[key].Value);
    }

    Console.WriteLine();
}

' Show how to use OpenWebConfiguration(string, string, 
' string, string).
' It gets he appSettings section of a Web application 
' running on the specified server. 
' If the server is remote your application must have the
' required access rights to the configuration file. 
Shared Sub OpenWebConfiguration4()
   ' Get the configuration object for a Web application
   ' running on the specified server.
   ' Null for the subPath signifies no subdir. 
   Dim config As System.Configuration.Configuration = WebConfigurationManager.OpenWebConfiguration("/configTest", "Default Web Site", Nothing, "myServer")
   
   ' Get the appSettings.
   Dim appSettings As KeyValueConfigurationCollection = config.AppSettings.Settings
   
   
   ' Loop through the collection and
   ' display the appSettings key, value pairs.
   Console.WriteLine("[appSettings for Web app on server: myServer]")
   Dim key As String
   For Each key In  appSettings.AllKeys
      Console.WriteLine("Name: {0} Value: {1}", key, appSettings(key).Value)
   Next key
   
   Console.WriteLine()
End Sub

Comentários

Para obter o Configuration objeto para um recurso remoto, seu código deve ter privilégios administrativos no computador remoto.

Confira também

Configuration

Aplica-se a

OpenWebConfiguration(String, String, String, String, IntPtr)

Abre o arquivo de configuração de aplicativo Web como um objeto Configuration usando o caminho virtual, nome do site, local, servidor e contexto de segurança especificados para permitir operações de leitura ou gravação.

public:
 static System::Configuration::Configuration ^ OpenWebConfiguration(System::String ^ path, System::String ^ site, System::String ^ locationSubPath, System::String ^ server, IntPtr userToken);

public static System.Configuration.Configuration OpenWebConfiguration (string path, string site, string locationSubPath, string server, IntPtr userToken);

static member OpenWebConfiguration : string * string * string * string * nativeint -> System.Configuration.Configuration

Public Shared Function OpenWebConfiguration (path As String, site As String, locationSubPath As String, server As String, userToken As IntPtr) As Configuration

Parâmetros

path: String

O caminho virtual para o arquivo de configuração.

site: String

O nome do site do aplicativo, conforme exibido na configuração do IIS (Serviços de Informações da Internet).

locationSubPath: String

O recurso específico ao qual a configuração se aplica.

server: String

O nome de rede do servidor no qual o aplicativo Web reside.

userToken: IntPtr
nativeint

Um token de conta a ser usado.

Retornos

Configuration

Um objeto Configuration.

Exceções

ArgumentException

Os parâmetros server ou userToken eram inválidos.

ConfigurationErrorsException

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

Exemplos

O exemplo a seguir mostra como usar o OpenWebConfiguration método para acessar informações de configuração.


// Show how to use OpenWebConfiguration(string, string, 
// string, string, IntPtr).
// It gets he appSettings section of a Web application 
// running on a remote server. 
// If the serve is remote your application shall have the
// requires access rights to the configuration file. 
static void OpenWebConfiguration6()
{

    IntPtr userToken = 
        System.Security.Principal.WindowsIdentity.GetCurrent().Token;
   
    string user = 
        System.Security.Principal.WindowsIdentity.GetCurrent().Name;
    
    // Get the configuration object for a Web application
    // running on a remote server.
    System.Configuration.Configuration config =
        WebConfigurationManager.OpenWebConfiguration(
        "/configTest", "Default Web Site", null, 
        "myServer", userToken) as System.Configuration.Configuration;

    // Get the appSettings.
    KeyValueConfigurationCollection appSettings =
         config.AppSettings.Settings;

    // Loop through the collection and
    // display the appSettings key, value pairs.
    Console.WriteLine(
        "[appSettings for Web app on server: myServer user: {0}]", user);
    foreach (string key in appSettings.AllKeys)
    {
        Console.WriteLine("Name: {0} Value: {1}",
        key, appSettings[key].Value);
    }

    Console.WriteLine();
}

' Show how to use OpenWebConfiguration(string, string, 
' string, string, IntPtr).
' It gets he appSettings section of a Web application 
' running on a remote server. 
' If the serve is remote your application shall have the
' requires access rights to the configuration file. 
Shared Sub OpenWebConfiguration6()
   
     Dim userToken As IntPtr = _
     System.Security.Principal.WindowsIdentity.GetCurrent().Token
   
     Dim user As String = _
     System.Security.Principal.WindowsIdentity.GetCurrent().Name
   
   ' Get the configuration object for a Web application
   ' running on a remote server.
     Dim config As System.Configuration.Configuration = _
     WebConfigurationManager.OpenWebConfiguration( _
     "/configTest", "Default Web Site", _
     Nothing, "myServer", userToken)
   
   ' Get the appSettings.
     Dim appSettings As KeyValueConfigurationCollection = _
     config.AppSettings.Settings
   
   ' Loop through the collection and
   ' display the appSettings key, value pairs.
     Console.WriteLine( _
     "[appSettings for Web app on server: myServer user: {0}]", user)
   Dim key As String
   For Each key In  appSettings.AllKeys
         Console.WriteLine("Name: {0} Value: {1}", _
         key, appSettings(key).Value)
   Next key
   
   Console.WriteLine()
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 LogonUserde Windows. Para obter mais informações sobre chamadas para código não gerenciado, consulte Consuming Unmanaged DLL Functions.

Para obter o Configuration objeto para um recurso remoto, seu código deve ter privilégios administrativos no computador remoto.

Confira também

Aplica-se a

OpenWebConfiguration(String, String, String, String, String, String)

public:
 static System::Configuration::Configuration ^ OpenWebConfiguration(System::String ^ path, System::String ^ site, System::String ^ locationSubPath, System::String ^ server, System::String ^ userName, System::String ^ password);

public static System.Configuration.Configuration OpenWebConfiguration (string path, string site, string locationSubPath, string server, string userName, string password);

static member OpenWebConfiguration : string * string * string * string * string * string -> System.Configuration.Configuration

Public Shared Function OpenWebConfiguration (path As String, site As String, locationSubPath As String, server As String, userName As String, password As String) As Configuration

Parâmetros

path: String

O caminho virtual para o arquivo de configuração.

site: String

O nome do site do aplicativo, conforme exibido na configuração do IIS (Serviços de Informações da Internet).

locationSubPath: String

O recurso específico ao qual a configuração se aplica.

server: String

O nome de rede do servidor no qual o aplicativo Web reside.

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 OpenWebConfiguration método.


// Show how to use OpenWebConfiguration(string, string, 
// string, string, string, string).
// It gets he appSettings section of a Web application 
// running on a remote server. 
// If the server is remote your application must have the
// required access rights to the configuration file. 
static void OpenWebConfiguration5()
{
    // Get the current user.
    string user =
        System.Security.Principal.WindowsIdentity.GetCurrent().Name;
    
    // Assign the actual password.
    string password = "userPassword";

    // Get the configuration object for a Web application
    // running on a remote server.
    System.Configuration.Configuration config =
        WebConfigurationManager.OpenWebConfiguration(
        "/configTest", "Default Web Site", null, "myServer",
        user, password) as System.Configuration.Configuration;

    // Get the appSettings.
    KeyValueConfigurationCollection appSettings =
         config.AppSettings.Settings;

    // Loop through the collection and
    // display the appSettings key, value pairs.
    Console.WriteLine(
        "[appSettings for Web app on server: myServer user: {0}]", user);
    foreach (string key in appSettings.AllKeys)
    {
        Console.WriteLine("Name: {0} Value: {1}",
        key, appSettings[key].Value);
    }

    Console.WriteLine();
}

' Show how to use OpenWebConfiguration(string, string, 
' string, string, string, string).
' It gets he appSettings section of a Web application 
' running on a remote server. 
' If the server is remote your application must have the
' required access rights to the configuration file. 
Shared Sub OpenWebConfiguration5()
   ' Get the current user.
     Dim user As String = _
     System.Security.Principal.WindowsIdentity.GetCurrent().Name
   
   ' Assign the actual password.
   Dim password As String = "userPassword"
   
   ' Get the configuration object for a Web application
   ' running on a remote server.
     Dim config As System.Configuration.Configuration = _
     WebConfigurationManager.OpenWebConfiguration( _
     "/configTest", "Default Web Site", _
     Nothing, "myServer", user, password)
   
   ' Get the appSettings.
     Dim appSettings As KeyValueConfigurationCollection = _
     config.AppSettings.Settings
   
   
   ' Loop through the collection and
   ' display the appSettings key, value pairs.
     Console.WriteLine( _
     "[appSettings for Web app on server: myServer user: {0}]", user)
   Dim key As String
   For Each key In  appSettings.AllKeys
         Console.WriteLine("Name: {0} Value: {1}", _
         key, appSettings(key).Value)
   Next key
   
   Console.WriteLine()
End Sub

Comentários

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

Para obter o Configuration objeto para um recurso remoto, seu código deve ter privilégios administrativos no computador remoto.

Talvez seja necessário executar a ASP.NET Ferramenta de Registro do IIS (Aspnet_regiis.exe) com a opção de habilitar o -config+ acesso aos arquivos de configuração no computador remoto.

Confira também

Aplica-se a

WebConfigurationManager.OpenWebConfiguration Método

Definição

Sobrecargas

OpenWebConfiguration(String)

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

OpenWebConfiguration(String, String)

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

OpenWebConfiguration(String, String, String)

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

OpenWebConfiguration(String, String, String, String)

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

OpenWebConfiguration(String, String, String, String, IntPtr)

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

OpenWebConfiguration(String, String, String, String, String, String)

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

Recursos adicionais