WebConfigurationManager.OpenWebConfiguration Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Öffnet die Webanwendungskonfigurationsdatei als Configuration-Objekt.
Überlädt
OpenWebConfiguration(String) |
Öffnet die Webanwendungskonfigurationsdatei als Configuration-Objekt, um mithilfe des angegebenen virtuellen Pfads Lese- oder Schreibvorgänge zu ermöglichen. |
OpenWebConfiguration(String, String) |
Öffnet die Webanwendungskonfigurationsdatei als Configuration-Objekt, um mithilfe des angegebenen virtuellen Pfads und des Websitenamens Lese- oder Schreibvorgänge zu ermöglichen. |
OpenWebConfiguration(String, String, String) |
Öffnet die Webanwendungskonfigurationsdatei als Configuration-Objekt, um mithilfe des angegebenen virtuellen Pfads, des Websitenamens und des Speicherorts Lese- oder Schreibvorgänge zu ermöglichen. |
OpenWebConfiguration(String, String, String, String) |
Öffnet die Webanwendungskonfigurationsdatei als Configuration-Objekt, um mithilfe des angegebenen virtuellen Pfads, des Websitenamens, des Speicherorts und des Servers Lese- oder Schreibvorgänge zu ermöglichen. |
OpenWebConfiguration(String, String, String, String, IntPtr) |
Öffnet die Webanwendungskonfigurationsdatei als Configuration-Objekt, um mithilfe des angegebenen virtuellen Pfads, des Websitenamens, des Speicherorts, des Servers und des Sicherheitskontexts Lese- oder Schreibvorgänge zu ermöglichen. |
OpenWebConfiguration(String, String, String, String, String, String) |
Öffnet die Webanwendungskonfigurationsdatei als Configuration-Objekt, um mithilfe des angegebenen virtuellen Pfads, des Websitenamens, des Speicherorts, des Servers und des Sicherheitskontexts Lese- oder Schreibvorgänge zu ermöglichen. |
OpenWebConfiguration(String)
Öffnet die Webanwendungskonfigurationsdatei als Configuration-Objekt, um mithilfe des angegebenen virtuellen Pfads Lese- oder Schreibvorgänge zu ermöglichen.
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
Parameter
- path
- String
Der virtuelle Pfad zur Konfigurationsdatei. Wenn null
festgelegt ist, wird die Stammdatei Web.config geöffnet.
Gibt zurück
Ein Configuration-Objekt.
Ausnahmen
Es konnte keine gültige Konfigurationsdatei geladen werden.
Beispiele
Das folgende Beispiel zeigt, wie Sie mit der OpenWebConfiguration -Methode auf Konfigurationsinformationen zugreifen.
// 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
Hinweise
Um das Configuration Objekt für eine Ressource abzurufen, muss Ihr Code Leseberechtigungen für alle Konfigurationsdateien aufweisen, von denen er Einstellungen erbt. Um eine Konfigurationsdatei zu aktualisieren, muss Ihr Code zusätzlich Über Schreibberechtigungen für die Konfigurationsdatei und das Verzeichnis verfügen, in dem er sich befindet.
Weitere Informationen
Gilt für:
OpenWebConfiguration(String, String)
Öffnet die Webanwendungskonfigurationsdatei als Configuration-Objekt, um mithilfe des angegebenen virtuellen Pfads und des Websitenamens Lese- oder Schreibvorgänge zu ermöglichen.
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
Parameter
- path
- String
Der virtuelle Pfad zur Konfigurationsdatei.
- site
- String
Der Name der Anwendungswebsite, wie in der Konfiguration von Internetinformationsdienste (IIS) angezeigt.
Gibt zurück
Ein Configuration-Objekt.
Ausnahmen
Es konnte keine gültige Konfigurationsdatei geladen werden.
Beispiele
Das folgende Beispiel zeigt, wie Sie mit der OpenWebConfiguration -Methode auf Konfigurationsinformationen zugreifen.
// 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
Hinweise
Um das Configuration Objekt für eine Ressource abzurufen, muss Ihr Code Leseberechtigungen für alle Konfigurationsdateien aufweisen, von denen er Einstellungen erbt. Um eine Konfigurationsdatei zu aktualisieren, muss Ihr Code zusätzlich Über Schreibberechtigungen für die Konfigurationsdatei und das Verzeichnis verfügen, in dem er sich befindet.
Weitere Informationen
Gilt für:
OpenWebConfiguration(String, String, String)
Öffnet die Webanwendungskonfigurationsdatei als Configuration-Objekt, um mithilfe des angegebenen virtuellen Pfads, des Websitenamens und des Speicherorts Lese- oder Schreibvorgänge zu ermöglichen.
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
Parameter
- path
- String
Der virtuelle Pfad zur Konfigurationsdatei.
- site
- String
Der Name der Anwendungswebsite, wie in der Konfiguration von Internetinformationsdienste (IIS) angezeigt.
- locationSubPath
- String
Die bestimmte Ressource, für die die Konfiguration gilt.
Gibt zurück
Ein Configuration-Objekt.
Ausnahmen
Es konnte keine gültige Konfigurationsdatei geladen werden.
Beispiele
Das folgende Beispiel zeigt, wie Sie mit der OpenWebConfiguration -Methode auf Konfigurationsinformationen zugreifen.
// 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
Hinweise
Um das Configuration Objekt für eine Ressource abzurufen, muss Ihr Code Leseberechtigungen für alle Konfigurationsdateien aufweisen, von denen er Einstellungen erbt. Um eine Konfigurationsdatei zu aktualisieren, muss Ihr Code zusätzlich Über Schreibberechtigungen für die Konfigurationsdatei und das Verzeichnis verfügen, in dem er sich befindet.
Weitere Informationen
Gilt für:
OpenWebConfiguration(String, String, String, String)
Öffnet die Webanwendungskonfigurationsdatei als Configuration-Objekt, um mithilfe des angegebenen virtuellen Pfads, des Websitenamens, des Speicherorts und des Servers Lese- oder Schreibvorgänge zu ermöglichen.
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
Parameter
- path
- String
Der virtuelle Pfad zur Konfigurationsdatei.
- site
- String
Der Name der Anwendungswebsite, wie in der Konfiguration von Internetinformationsdienste (IIS) angezeigt.
- locationSubPath
- String
Die bestimmte Ressource, für die die Konfiguration gilt.
- server
- String
Der Netzwerkname des Servers, auf dem sich die Webanwendung befindet.
Gibt zurück
Ein Configuration-Objekt.
Ausnahmen
Der Serverparameter war ungültig.
Es konnte keine gültige Konfigurationsdatei geladen werden.
Beispiele
Das folgende Beispiel zeigt, wie Sie mit der OpenWebConfiguration -Methode auf Konfigurationsinformationen zugreifen.
// 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
Hinweise
Um das Configuration Objekt für eine Remoteressource abzurufen, muss Ihr Code über Administratorrechte auf dem Remotecomputer verfügen.
Weitere Informationen
Gilt für:
OpenWebConfiguration(String, String, String, String, IntPtr)
Öffnet die Webanwendungskonfigurationsdatei als Configuration-Objekt, um mithilfe des angegebenen virtuellen Pfads, des Websitenamens, des Speicherorts, des Servers und des Sicherheitskontexts Lese- oder Schreibvorgänge zu ermöglichen.
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
Parameter
- path
- String
Der virtuelle Pfad zur Konfigurationsdatei.
- site
- String
Der Name der Anwendungswebsite, wie in der Konfiguration von Internetinformationsdienste (IIS) angezeigt.
- locationSubPath
- String
Die bestimmte Ressource, für die die Konfiguration gilt.
- server
- String
Der Netzwerkname des Servers, auf dem sich die Webanwendung befindet.
- userToken
-
IntPtr
nativeint
Ein zu verwendendes Kontotoken.
Gibt zurück
Ein Configuration-Objekt.
Ausnahmen
Der server
-Parameter oder der userToken
-Parameter war ungültig.
Es konnte keine gültige Konfigurationsdatei geladen werden.
Beispiele
Das folgende Beispiel zeigt, wie Sie die OpenWebConfiguration -Methode verwenden, um auf Konfigurationsinformationen zuzugreifen.
// 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
Hinweise
Diese Methode wird verwendet, um mithilfe des Identitätswechsels auf eine Konfigurationsdatei zuzugreifen.
Hinweis
Das Kontotoken wird in der Regel von einer Instanz der WindowsIdentity -Klasse oder über einen Aufruf von nicht verwaltetem Code abgerufen, z. B. durch einen Aufruf der Windows-API LogonUser
. Weitere Informationen zu Aufrufen von nicht verwaltetem Code finden Sie unter Verwenden nicht verwalteter DLL-Funktionen.
Um das Configuration Objekt für eine Remoteressource abzurufen, muss Ihr Code über Administratorrechte auf dem Remotecomputer verfügen.
Weitere Informationen
Gilt für:
OpenWebConfiguration(String, String, String, String, String, String)
Öffnet die Webanwendungskonfigurationsdatei als Configuration-Objekt, um mithilfe des angegebenen virtuellen Pfads, des Websitenamens, des Speicherorts, des Servers und des Sicherheitskontexts Lese- oder Schreibvorgänge zu ermöglichen.
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
Parameter
- path
- String
Der virtuelle Pfad zur Konfigurationsdatei.
- site
- String
Der Name der Anwendungswebsite, wie in der Konfiguration von Internetinformationsdienste (IIS) angezeigt.
- locationSubPath
- String
Die bestimmte Ressource, für die die Konfiguration gilt.
- server
- String
Der Netzwerkname des Servers, auf dem sich die Webanwendung befindet.
- userName
- String
Der vollständige Benutzername (Domäne\Benutzer) zum Öffnen der Datei.
- password
- String
Das Kennwort für den Benutzernamen.
Gibt zurück
Ein Configuration-Objekt.
Ausnahmen
Der server
-Parameter oder der userName
-Parameter und der password
-Parameter waren ungültig.
Es konnte keine gültige Konfigurationsdatei geladen werden.
Beispiele
Das folgende Beispiel zeigt, wie Sie mit der OpenWebConfiguration -Methode auf Konfigurationsinformationen zugreifen.
// 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
Hinweise
Diese Methode wird verwendet, um mithilfe des Identitätswechsels auf eine Konfigurationsdatei zuzugreifen.
Um das Configuration Objekt für eine Remoteressource abzurufen, muss Ihr Code über Administratorrechte auf dem Remotecomputer verfügen.
Möglicherweise müssen Sie das ASP.NET IIS-Registrierungstool (Aspnet_regiis.exe) mit der -config+
Option ausführen, den Zugriff auf die Konfigurationsdateien auf dem Remotecomputer zu aktivieren.