WebConfigurationManager.OpenWebConfiguration Método

Referencia

Definición

Espacio de nombres:: System.Web.Configuration

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Abre el archivo de configuración de la aplicación Web como un objeto Configuration.

Sobrecargas

OpenWebConfiguration(String)	Abre el archivo de configuración de la aplicación Web como un objeto Configuration utilizando la ruta de acceso virtual especificada para permitir operaciones de lectura o escritura.
OpenWebConfiguration(String, String)	Abre el archivo de configuración de la aplicación Web como un objeto Configuration utilizando la ruta de acceso virtual y el nombre de sitio especificados para permitir operaciones de lectura o escritura.
OpenWebConfiguration(String, String, String)	Abre el archivo de configuración de la aplicación Web como un objeto Configuration utilizando la ruta de acceso virtual, el nombre de sitio y la ubicación especificados para permitir operaciones de lectura o escritura.
OpenWebConfiguration(String, String, String, String)	Abre el archivo de configuración de la aplicación Web como un objeto Configuration utilizando la ruta de acceso virtual, el nombre de sitio, la ubicación y el servidor especificados para permitir operaciones de lectura o escritura.
OpenWebConfiguration(String, String, String, String, IntPtr)	Abre el archivo de configuración de la aplicación Web como un objeto Configuration utilizando la ruta de acceso virtual, el nombre de sitio, la ubicación, el servidor y el contexto de seguridad especificados para permitir operaciones de lectura o escritura.
OpenWebConfiguration(String, String, String, String, String, String)	Abre el archivo de configuración de la aplicación Web como un objeto Configuration utilizando la ruta de acceso virtual, el nombre de sitio, la ubicación, el servidor y el contexto de seguridad especificados para permitir operaciones de lectura o escritura.

OpenWebConfiguration(String)

Abre el archivo de configuración de la aplicación Web como un objeto Configuration utilizando la ruta de acceso virtual especificada para permitir operaciones de lectura o escritura.

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

Ruta de acceso virtual al archivo de configuración. Si es null, se abre archivo raíz Web.config.

Devoluciones

Configuration

Un objeto Configuration.

Excepciones

ConfigurationErrorsException

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

Ejemplos

En el ejemplo siguiente se muestra cómo obtener acceso a la información de configuración con el 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

Comentarios

Para obtener el Configuration objeto de un recurso, el código debe tener privilegios de lectura en todos los archivos de configuración de los que hereda la configuración. Para actualizar un archivo de configuración, el código también debe tener privilegios de escritura para el archivo de configuración y el directorio en el que existe.

Consulte también

Configuration

Se aplica a

OpenWebConfiguration(String, String)

Abre el archivo de configuración de la aplicación Web como un objeto Configuration utilizando la ruta de acceso virtual y el nombre de sitio especificados para permitir operaciones de lectura o escritura.

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

Ruta de acceso virtual al archivo de configuración.

site: String

Nombre del sitio Web de la aplicación, tal como se muestra en la configuración de IIS (Microsoft Internet Information Services).

Devoluciones

Configuration

Un objeto Configuration.

Excepciones

ConfigurationErrorsException

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

Ejemplos

En el ejemplo siguiente se muestra cómo obtener acceso a la información de configuración con el 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

Comentarios

Consulte también

Configuration

Se aplica a

OpenWebConfiguration(String, String, String)

Abre el archivo de configuración de la aplicación Web como un objeto Configuration utilizando la ruta de acceso virtual, el nombre de sitio y la ubicación especificados para permitir operaciones de lectura o escritura.

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

Ruta de acceso virtual al archivo de configuración.

site: String

Nombre del sitio Web de la aplicación, tal como se muestra en la configuración de IIS (Microsoft Internet Information Services).

locationSubPath: String

Recurso específico al que se aplica la configuración.

Devoluciones

Configuration

Un objeto Configuration.

Excepciones

ConfigurationErrorsException

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

Ejemplos

En el ejemplo siguiente se muestra cómo obtener acceso a la información de configuración con el 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

Comentarios

Consulte también

Configuration

Se aplica a

OpenWebConfiguration(String, String, String, String)

Abre el archivo de configuración de la aplicación Web como un objeto Configuration utilizando la ruta de acceso virtual, el nombre de sitio, la ubicación y el servidor especificados para permitir operaciones de lectura o escritura.

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

Ruta de acceso virtual al archivo de configuración.

site: String

Nombre del sitio Web de la aplicación, tal como se muestra en la configuración de IIS (Microsoft Internet Information Services).

locationSubPath: String

Recurso específico al que se aplica la configuración.

server: String

Nombre de red del servidor en el que reside la aplicación Web.

Devoluciones

Configuration

Un objeto Configuration.

Excepciones

ArgumentException

El parámetro de servidor no fue válido.

ConfigurationErrorsException

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

Ejemplos

En el ejemplo siguiente se muestra cómo obtener acceso a la información de configuración con el 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

Comentarios

Para obtener el Configuration objeto de un recurso remoto, el código debe tener privilegios administrativos en el equipo remoto.

Consulte también

Configuration

Se aplica a

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

Abre el archivo de configuración de la aplicación Web como un objeto Configuration utilizando la ruta de acceso virtual, el nombre de sitio, la ubicación, el servidor y el contexto de seguridad especificados para permitir operaciones de lectura o escritura.

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

Ruta de acceso virtual al archivo de configuración.

site: String

Nombre del sitio Web de la aplicación, tal como se muestra en la configuración de IIS (Microsoft Internet Information Services).

locationSubPath: String

Recurso específico al que se aplica la configuración.

server: String

Nombre de red del servidor en el que reside la aplicación Web.

userToken: IntPtr
nativeint

Símbolo (token) de la cuenta que se utilizará.

Devoluciones

Configuration

Un objeto Configuration.

Excepciones

ArgumentException

Los parámetros server o userToken no eran válidos.

ConfigurationErrorsException

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

Ejemplos

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


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

Comentarios

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

Nota

Normalmente, el token de cuenta se recupera de una instancia de la WindowsIdentity clase o a través de una llamada al código no administrado, como una llamada a la API LogonUserde Windows . Para obtener más información sobre las llamadas a código no administrado, consulte Consumo de funciones DLL no administradas.

Para obtener el Configuration objeto de un recurso remoto, el código debe tener privilegios administrativos en el equipo remoto.

Consulte también

Se aplica 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

Ruta de acceso virtual al archivo de configuración.

site: String

Nombre del sitio Web de la aplicación, tal como se muestra en la configuración de IIS (Microsoft Internet Information Services).

locationSubPath: String

Recurso específico al que se aplica la configuración.

server: String

Nombre de red del servidor en el que reside la aplicación Web.

userName: String

Nombre de usuario completo (Domain\User) que se utilizará al abrir el archivo.

password: String

Contraseña del nombre de usuario.

Devoluciones

Configuration

Un objeto Configuration.

Excepciones

ArgumentException

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

ConfigurationErrorsException

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

Ejemplos

En el ejemplo siguiente se muestra cómo obtener acceso a la información de configuración con el 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

Comentarios

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

Para obtener el Configuration objeto de un recurso remoto, el código debe tener privilegios administrativos en el equipo remoto.

Es posible que tenga que ejecutar la herramienta de registro de IIS (Aspnet_regiis.exe) de ASP.NET con la opción de habilitar el -config+ acceso a los archivos de configuración en el equipo remoto.

Consulte también

Se aplica a

Compartir a través de

WebConfigurationManager.OpenWebConfiguration Método

Definición

Sobrecargas

OpenWebConfiguration(String)

Parámetros

Devoluciones

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

OpenWebConfiguration(String, String)

Parámetros

Devoluciones

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

OpenWebConfiguration(String, String, String)

Parámetros

Devoluciones

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

OpenWebConfiguration(String, String, String, String)

Parámetros

Devoluciones

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

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

Parámetros

Devoluciones

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

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

Parámetros

Devoluciones

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

Recursos adicionales