WebConfigurationManager.OpenWebConfiguration Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Web.Configuration

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Apre il file di configurazione dell'applicazione Web come oggetto Configuration.

Overload

OpenWebConfiguration(String)	Apre il file di configurazione dell'applicazione Web come oggetto Configuration, utilizzando il percorso virtuale specificato per consentire le operazioni di lettura e scrittura.
OpenWebConfiguration(String, String)	Apre il file di configurazione dell'applicazione Web come oggetto Configuration, utilizzando il percorso virtuale specificato e il nome del sito per consentire le operazioni di lettura e scrittura.
OpenWebConfiguration(String, String, String)	Apre il file di configurazione dell'applicazione Web come oggetto Configuration, utilizzando il percorso virtuale specificato, il nome del sito e il percorso per consentire le operazioni di lettura e scrittura.
OpenWebConfiguration(String, String, String, String)	Apre il file di configurazione dell'applicazione Web come oggetto Configuration, utilizzando il percorso virtuale specificato, il nome del sito, il percorso e il server per consentire le operazioni di lettura e scrittura.
OpenWebConfiguration(String, String, String, String, IntPtr)	Apre il file di configurazione dell'applicazione Web come oggetto Configuration, utilizzando il percorso virtuale specificato, il nome del sito, il percorso, il server e il contesto di sicurezza per consentire le operazioni di lettura e scrittura.
OpenWebConfiguration(String, String, String, String, String, String)	Apre il file di configurazione dell'applicazione Web come oggetto Configuration, utilizzando il percorso virtuale specificato, il nome del sito, il percorso, il server e il contesto di sicurezza per consentire le operazioni di lettura e scrittura.

OpenWebConfiguration(String)

Apre il file di configurazione dell'applicazione Web come oggetto Configuration, utilizzando il percorso virtuale specificato per consentire le operazioni di lettura e scrittura.

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

Parametri

path: String

Percorso virtuale del file di configurazione. Se null, viene aperto il file Web.config a livello di radice.

Restituisce

Configuration

Un oggetto Configuration.

Eccezioni

ConfigurationErrorsException

Impossibile caricare un file di configurazione valido.

Esempio

Nell'esempio seguente viene illustrato come accedere alle informazioni di configurazione con il OpenWebConfiguration metodo .


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

Commenti

Per ottenere l'oggetto Configuration per una risorsa, il codice deve disporre dei privilegi di lettura per tutti i file di configurazione da cui eredita le impostazioni. Per aggiornare un file di configurazione, il codice deve inoltre disporre dei privilegi di scrittura sia per il file di configurazione che per la directory in cui esiste.

Vedi anche

Configuration

Si applica a

OpenWebConfiguration(String, String)

Apre il file di configurazione dell'applicazione Web come oggetto Configuration, utilizzando il percorso virtuale specificato e il nome del sito per consentire le operazioni di lettura e scrittura.

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

Parametri

path: String

Percorso virtuale del file di configurazione.

site: String

Nome del sito Web dell'applicazione visualizzato nella configurazione Internet Information Services (IIS).

Restituisce

Configuration

Un oggetto Configuration.

Eccezioni

ConfigurationErrorsException

Impossibile caricare un file di configurazione valido.

Esempio

Nell'esempio seguente viene illustrato come accedere alle informazioni di configurazione con il OpenWebConfiguration metodo .


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

Commenti

Vedi anche

Configuration

Si applica a

OpenWebConfiguration(String, String, String)

Apre il file di configurazione dell'applicazione Web come oggetto Configuration, utilizzando il percorso virtuale specificato, il nome del sito e il percorso per consentire le operazioni di lettura e scrittura.

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

Parametri

path: String

Percorso virtuale del file di configurazione.

site: String

Nome del sito Web dell'applicazione visualizzato nella configurazione Internet Information Services (IIS).

locationSubPath: String

Risorsa specifica a cui viene applicata la configurazione.

Restituisce

Configuration

Un oggetto Configuration.

Eccezioni

ConfigurationErrorsException

Impossibile caricare un file di configurazione valido.

Esempio

Nell'esempio seguente viene illustrato come accedere alle informazioni di configurazione con il OpenWebConfiguration metodo .


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

Commenti

Vedi anche

Configuration

Si applica a

OpenWebConfiguration(String, String, String, String)

Apre il file di configurazione dell'applicazione Web come oggetto Configuration, utilizzando il percorso virtuale specificato, il nome del sito, il percorso e il server per consentire le operazioni di lettura e scrittura.

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

Parametri

path: String

Percorso virtuale del file di configurazione.

site: String

Nome del sito Web dell'applicazione visualizzato nella configurazione Internet Information Services (IIS).

locationSubPath: String

Risorsa specifica a cui viene applicata la configurazione.

server: String

Nome di rete del server sul quale risiede l'applicazione Web.

Restituisce

Configuration

Un oggetto Configuration.

Eccezioni

ArgumentException

Parametro del server non valido.

ConfigurationErrorsException

Impossibile caricare un file di configurazione valido.

Esempio

Nell'esempio seguente viene illustrato come accedere alle informazioni di configurazione con il OpenWebConfiguration metodo .


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

Commenti

Per ottenere l'oggetto Configuration per una risorsa remota, il codice deve disporre di privilegi amministrativi nel computer remoto.

Vedi anche

Configuration

Si applica a

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

Apre il file di configurazione dell'applicazione Web come oggetto Configuration, utilizzando il percorso virtuale specificato, il nome del sito, il percorso, il server e il contesto di sicurezza per consentire le operazioni di lettura e scrittura.

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

Parametri

path: String

Percorso virtuale del file di configurazione.

site: String

Nome del sito Web dell'applicazione visualizzato nella configurazione Internet Information Services (IIS).

locationSubPath: String

Risorsa specifica a cui viene applicata la configurazione.

server: String

Nome di rete del server sul quale risiede l'applicazione Web.

userToken: IntPtr
nativeint

Token di account da utilizzare.

Restituisce

Configuration

Un oggetto Configuration.

Eccezioni

ArgumentException

Il parametro server o userToken non è valido.

ConfigurationErrorsException

Impossibile caricare un file di configurazione valido.

Esempio

Nell'esempio seguente viene illustrato come usare il OpenWebConfiguration metodo per accedere alle informazioni di configurazione.


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

Commenti

Questo metodo viene usato per accedere a un file di configurazione usando la rappresentazione.

Nota

Il token dell'account viene in genere recuperato da un'istanza della WindowsIdentity classe o tramite una chiamata a codice non gestito, ad esempio una chiamata all'API LogonUserdi Windows. Per altre informazioni sulle chiamate a codice non gestito, vedere Utilizzo di funzioni DLL non gestite.

Per ottenere l'oggetto Configuration per una risorsa remota, il codice deve disporre di privilegi amministrativi nel computer remoto.

Vedi anche

Si applica 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

Parametri

path: String

Percorso virtuale del file di configurazione.

site: String

Nome del sito Web dell'applicazione visualizzato nella configurazione Internet Information Services (IIS).

locationSubPath: String

Risorsa specifica a cui viene applicata la configurazione.

server: String

Nome di rete del server sul quale risiede l'applicazione Web.

userName: String

Nome utente completo (Dominio\Utente) da utilizzare durante l'apertura del file.

password: String

Password per il nome utente.

Restituisce

Configuration

Un oggetto Configuration.

Eccezioni

ArgumentException

I parametri server o userName e password non sono validi.

ConfigurationErrorsException

Impossibile caricare un file di configurazione valido.

Esempio

Nell'esempio seguente viene illustrato come accedere alle informazioni di configurazione con il OpenWebConfiguration metodo .


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

Commenti

Questo metodo viene usato per accedere a un file di configurazione usando la rappresentazione.

Per ottenere l'oggetto Configuration per una risorsa remota, il codice deve disporre di privilegi amministrativi nel computer remoto.

Potrebbe essere necessario eseguire ASP.NET iis Registration Tool (Aspnet_regiis.exe) con l'opzione -config+ per abilitare l'accesso ai file di configurazione nel computer remoto.

Vedi anche

Si applica a

Condividi tramite

WebConfigurationManager.OpenWebConfiguration Metodo

Definizione

Overload

OpenWebConfiguration(String)

Parametri

Restituisce

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

OpenWebConfiguration(String, String)

Parametri

Restituisce

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

OpenWebConfiguration(String, String, String)

Parametri

Restituisce

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

OpenWebConfiguration(String, String, String, String)

Parametri

Restituisce

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

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

Parametri

Restituisce

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

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

Parametri

Restituisce

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

Risorse aggiuntive