WebConfigurationManager.OpenWebConfiguration Metoda

Reference

Definice

Obor názvů:: System.Web.Configuration

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Otevře konfigurační soubor webové aplikace jako Configuration objekt.

Přetížení

OpenWebConfiguration(String)	Otevře konfigurační soubor webové aplikace jako objekt používající zadanou Configuration virtuální cestu pro povolení operací čtení nebo zápisu.
OpenWebConfiguration(String, String)	Otevře konfigurační soubor webové aplikace jako objekt používající zadanou Configuration virtuální cestu a název lokality, aby bylo možné operace čtení nebo zápisu.
OpenWebConfiguration(String, String, String)	Otevře konfigurační soubor webové aplikace jako objekt používající zadanou Configuration virtuální cestu, název webu a umístění pro povolení operací čtení nebo zápisu.
OpenWebConfiguration(String, String, String, String)	Otevře konfigurační soubor webové aplikace jako objekt používající zadanou Configuration virtuální cestu, název webu, umístění a server pro povolení operací čtení nebo zápisu.
OpenWebConfiguration(String, String, String, String, IntPtr)	Otevře konfigurační soubor webové aplikace jako Configuration objekt s použitím zadané virtuální cesty, názvu lokality, umístění, serveru a kontextu zabezpečení, aby bylo možné operace čtení nebo zápisu.
OpenWebConfiguration(String, String, String, String, String, String)	Otevře konfigurační soubor webové aplikace jako Configuration objekt s použitím zadané virtuální cesty, názvu lokality, umístění, serveru a kontextu zabezpečení, aby bylo možné operace čtení nebo zápisu.

OpenWebConfiguration(String)

Otevře konfigurační soubor webové aplikace jako objekt používající zadanou Configuration virtuální cestu pro povolení operací čtení nebo zápisu.

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

Parametry

path: String

Virtuální cesta ke konfiguračnímu souboru. Pokud null, kořenový Web.config soubor je otevřen.

Návraty

Configuration

Objekt Configuration .

Výjimky

ConfigurationErrorsException

Nelze načíst platný konfigurační soubor.

Příklady

Následující příklad ukazuje, jak získat přístup ke konfiguračním informacím OpenWebConfiguration pomocí metody .


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

Poznámky

Chcete-li získat Configuration objekt pro prostředek, váš kód musí mít oprávnění ke čtení u všech konfiguračních souborů, ze kterých dědí nastavení. Chcete-li aktualizovat konfigurační soubor, musí mít kód navíc oprávnění k zápisu pro konfigurační soubor i adresář, ve kterém existuje.

Viz také

Configuration

Platí pro

OpenWebConfiguration(String, String)

Otevře konfigurační soubor webové aplikace jako objekt používající zadanou Configuration virtuální cestu a název lokality, aby bylo možné operace čtení nebo zápisu.

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

Parametry

path: String

Virtuální cesta ke konfiguračnímu souboru.

site: String

Název webu aplikace zobrazený v konfiguraci Internetové informační služby (IIS).

Návraty

Configuration

Objekt Configuration .

Výjimky

ConfigurationErrorsException

Nelze načíst platný konfigurační soubor.

Příklady

Následující příklad ukazuje, jak získat přístup ke konfiguračním informacím OpenWebConfiguration pomocí metody .


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

Poznámky

Viz také

Configuration

Platí pro

OpenWebConfiguration(String, String, String)

Otevře konfigurační soubor webové aplikace jako objekt používající zadanou Configuration virtuální cestu, název webu a umístění pro povolení operací čtení nebo zápisu.

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

Parametry

path: String

Virtuální cesta ke konfiguračnímu souboru.

site: String

Název webu aplikace zobrazený v konfiguraci Internetové informační služby (IIS).

locationSubPath: String

Konkrétní prostředek, na který se konfigurace vztahuje.

Návraty

Configuration

Objekt Configuration .

Výjimky

ConfigurationErrorsException

Nelze načíst platný konfigurační soubor.

Příklady

Následující příklad ukazuje, jak získat přístup ke konfiguračním informacím OpenWebConfiguration pomocí metody .


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

Poznámky

Viz také

Configuration

Platí pro

OpenWebConfiguration(String, String, String, String)

Otevře konfigurační soubor webové aplikace jako objekt používající zadanou Configuration virtuální cestu, název webu, umístění a server pro povolení operací čtení nebo zápisu.

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

Parametry

path: String

Virtuální cesta ke konfiguračnímu souboru.

site: String

Název webu aplikace zobrazený v konfiguraci Internetové informační služby (IIS).

locationSubPath: String

Konkrétní prostředek, na který se konfigurace vztahuje.

server: String

Síťový název serveru, na kterém se nachází webová aplikace.

Návraty

Configuration

Objekt Configuration .

Výjimky

ArgumentException

Parametr serveru byl neplatný.

ConfigurationErrorsException

Nelze načíst platný konfigurační soubor.

Příklady

Následující příklad ukazuje, jak získat přístup ke konfiguračním informacím OpenWebConfiguration pomocí metody .


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

Poznámky

Chcete-li získat Configuration objekt pro vzdálený prostředek, váš kód musí mít oprávnění správce na vzdáleném počítači.

Viz také

Configuration

Platí pro

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

Otevře konfigurační soubor webové aplikace jako Configuration objekt s použitím zadané virtuální cesty, názvu lokality, umístění, serveru a kontextu zabezpečení, aby bylo možné operace čtení nebo zápisu.

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

Parametry

path: String

Virtuální cesta ke konfiguračnímu souboru.

site: String

Název webu aplikace zobrazený v konfiguraci Internetové informační služby (IIS).

locationSubPath: String

Konkrétní prostředek, na který se konfigurace vztahuje.

server: String

Síťový název serveru, na kterém se nachází webová aplikace.

userToken: IntPtr
nativeint

Token účtu, který se má použít.

Návraty

Configuration

Objekt Configuration .

Výjimky

ArgumentException

Parametry server nebo userToken byly neplatné.

ConfigurationErrorsException

Nelze načíst platný konfigurační soubor.

Příklady

Následující příklad ukazuje, jak použít metodu OpenWebConfiguration pro přístup ke konfiguračním informacím.


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

Poznámky

Tato metoda se používá pro přístup ke konfiguračnímu souboru pomocí zosobnění.

Poznámka

Token účtu se obvykle načítá z instance WindowsIdentity třídy nebo voláním nespravovaného kódu, například voláním rozhraní API LogonUsersystému Windows . Další informace o volání nespravovaného kódu naleznete v tématu Využití nespravovaných funkcí knihovny DLL.

Chcete-li získat Configuration objekt pro vzdálený prostředek, váš kód musí mít oprávnění správce na vzdáleném počítači.

Viz také

Platí pro

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

Parametry

path: String

Virtuální cesta ke konfiguračnímu souboru.

site: String

Název webu aplikace zobrazený v konfiguraci Internetové informační služby (IIS).

locationSubPath: String

Konkrétní prostředek, na který se konfigurace vztahuje.

server: String

Síťový název serveru, na kterém se nachází webová aplikace.

userName: String

Úplné uživatelské jméno (Domain\User), které se má použít při otevírání souboru.

password: String

Heslo pro uživatelské jméno.

Návraty

Configuration

Objekt Configuration .

Výjimky

ArgumentException

Parametry server nebo userName a password byly neplatné.

ConfigurationErrorsException

Nelze načíst platný konfigurační soubor.

Příklady

Následující příklad ukazuje, jak získat přístup ke konfiguračním informacím OpenWebConfiguration pomocí metody .


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

Poznámky

Tato metoda se používá pro přístup ke konfiguračnímu souboru pomocí zosobnění.

Chcete-li získat Configuration objekt pro vzdálený prostředek, váš kód musí mít oprávnění správce na vzdáleném počítači.

Možná budete muset spustit ASP.NET nástroj pro registraci služby IIS (Aspnet_regiis.exe) s -config+ možností povolit přístup ke konfiguračním souborům ve vzdáleném počítači.

Viz také

Platí pro

Sdílet prostřednictvím

WebConfigurationManager.OpenWebConfiguration Metoda

Definice

Přetížení

OpenWebConfiguration(String)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Viz také

Platí pro

OpenWebConfiguration(String, String)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Viz také

Platí pro

OpenWebConfiguration(String, String, String)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Viz také

Platí pro

OpenWebConfiguration(String, String, String, String)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Viz také

Platí pro

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

Parametry

Návraty

Výjimky

Příklady

Poznámky

Viz také

Platí pro

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

Parametry

Návraty

Výjimky

Příklady

Poznámky

Viz také

Platí pro

Další materiály