WebConfigurationManager.OpenWebConfiguration Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Otwiera plik konfiguracji aplikacji internetowej jako Configuration obiekt.
Przeciążenia
OpenWebConfiguration(String) |
Otwiera plik konfiguracji aplikacji internetowej jako Configuration obiekt przy użyciu określonej ścieżki wirtualnej, aby zezwolić na operacje odczytu lub zapisu. |
OpenWebConfiguration(String, String) |
Otwiera plik konfiguracji aplikacji internetowej jako Configuration obiekt przy użyciu określonej ścieżki wirtualnej i nazwy witryny, aby umożliwić operacje odczytu lub zapisu. |
OpenWebConfiguration(String, String, String) |
Otwiera plik konfiguracji aplikacji internetowej jako Configuration obiekt przy użyciu określonej ścieżki wirtualnej, nazwy witryny i lokalizacji, aby umożliwić operacje odczytu lub zapisu. |
OpenWebConfiguration(String, String, String, String) |
Otwiera plik konfiguracji aplikacji internetowej jako Configuration obiekt przy użyciu określonej ścieżki wirtualnej, nazwy lokacji, lokalizacji i serwera, aby umożliwić operacje odczytu lub zapisu. |
OpenWebConfiguration(String, String, String, String, IntPtr) |
Otwiera plik konfiguracji aplikacji internetowej jako Configuration obiekt przy użyciu określonej ścieżki wirtualnej, nazwy lokacji, lokalizacji, serwera i kontekstu zabezpieczeń, aby umożliwić operacje odczytu lub zapisu. |
OpenWebConfiguration(String, String, String, String, String, String) |
Otwiera plik konfiguracji aplikacji internetowej jako Configuration obiekt przy użyciu określonej ścieżki wirtualnej, nazwy lokacji, lokalizacji, serwera i kontekstu zabezpieczeń, aby umożliwić operacje odczytu lub zapisu. |
OpenWebConfiguration(String)
Otwiera plik konfiguracji aplikacji internetowej jako Configuration obiekt przy użyciu określonej ścieżki wirtualnej, aby zezwolić na operacje odczytu lub zapisu.
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
Ścieżka wirtualna do pliku konfiguracji. Jeśli null
plik główny Web.config zostanie otwarty.
Zwraca
Obiekt Configuration.
Wyjątki
Nie można załadować prawidłowego pliku konfiguracji.
Przykłady
W poniższym przykładzie pokazano, jak uzyskać dostęp do informacji o konfiguracji za pomocą OpenWebConfiguration 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
Uwagi
Aby uzyskać Configuration obiekt zasobu, kod musi mieć uprawnienia do odczytu na wszystkich plikach konfiguracji, z których dziedziczy ustawienia. Aby zaktualizować plik konfiguracji, kod musi mieć dodatkowo uprawnienia do zapisu zarówno dla pliku konfiguracji, jak i katalogu, w którym istnieje.
Zobacz też
Dotyczy
OpenWebConfiguration(String, String)
Otwiera plik konfiguracji aplikacji internetowej jako Configuration obiekt przy użyciu określonej ścieżki wirtualnej i nazwy witryny, aby umożliwić operacje odczytu lub zapisu.
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
Ścieżka wirtualna do pliku konfiguracji.
- site
- String
Nazwa witryny sieci Web aplikacji wyświetlana w konfiguracji usług Internet Information Services (IIS).
Zwraca
Obiekt Configuration.
Wyjątki
Nie można załadować prawidłowego pliku konfiguracji.
Przykłady
W poniższym przykładzie pokazano, jak uzyskać dostęp do informacji o konfiguracji za pomocą OpenWebConfiguration 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
Uwagi
Aby uzyskać Configuration obiekt zasobu, kod musi mieć uprawnienia do odczytu na wszystkich plikach konfiguracji, z których dziedziczy ustawienia. Aby zaktualizować plik konfiguracji, kod musi mieć dodatkowo uprawnienia do zapisu zarówno dla pliku konfiguracji, jak i katalogu, w którym istnieje.
Zobacz też
Dotyczy
OpenWebConfiguration(String, String, String)
Otwiera plik konfiguracji aplikacji internetowej jako Configuration obiekt przy użyciu określonej ścieżki wirtualnej, nazwy witryny i lokalizacji, aby umożliwić operacje odczytu lub zapisu.
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
Ścieżka wirtualna do pliku konfiguracji.
- site
- String
Nazwa witryny sieci Web aplikacji wyświetlana w konfiguracji usług Internet Information Services (IIS).
- locationSubPath
- String
Określony zasób, do którego ma zastosowanie konfiguracja.
Zwraca
Obiekt Configuration.
Wyjątki
Nie można załadować prawidłowego pliku konfiguracji.
Przykłady
W poniższym przykładzie pokazano, jak uzyskać dostęp do informacji o konfiguracji za pomocą OpenWebConfiguration 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
Uwagi
Aby uzyskać Configuration obiekt zasobu, kod musi mieć uprawnienia do odczytu na wszystkich plikach konfiguracji, z których dziedziczy ustawienia. Aby zaktualizować plik konfiguracji, kod musi mieć dodatkowo uprawnienia do zapisu zarówno dla pliku konfiguracji, jak i katalogu, w którym istnieje.
Zobacz też
Dotyczy
OpenWebConfiguration(String, String, String, String)
Otwiera plik konfiguracji aplikacji internetowej jako Configuration obiekt przy użyciu określonej ścieżki wirtualnej, nazwy lokacji, lokalizacji i serwera, aby umożliwić operacje odczytu lub zapisu.
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
Ścieżka wirtualna do pliku konfiguracji.
- site
- String
Nazwa witryny sieci Web aplikacji wyświetlana w konfiguracji usług Internet Information Services (IIS).
- locationSubPath
- String
Określony zasób, do którego ma zastosowanie konfiguracja.
- server
- String
Nazwa sieciowa serwera, na którym znajduje się aplikacja sieci Web.
Zwraca
Obiekt Configuration.
Wyjątki
Parametr serwera był nieprawidłowy.
Nie można załadować prawidłowego pliku konfiguracji.
Przykłady
W poniższym przykładzie pokazano, jak uzyskać dostęp do informacji o konfiguracji za pomocą OpenWebConfiguration 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
Uwagi
Aby uzyskać Configuration obiekt dla zasobu zdalnego, kod musi mieć uprawnienia administracyjne na komputerze zdalnym.
Zobacz też
Dotyczy
OpenWebConfiguration(String, String, String, String, IntPtr)
Otwiera plik konfiguracji aplikacji internetowej jako Configuration obiekt przy użyciu określonej ścieżki wirtualnej, nazwy lokacji, lokalizacji, serwera i kontekstu zabezpieczeń, aby umożliwić operacje odczytu lub zapisu.
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
Ścieżka wirtualna do pliku konfiguracji.
- site
- String
Nazwa witryny sieci Web aplikacji wyświetlana w konfiguracji usług Internet Information Services (IIS).
- locationSubPath
- String
Określony zasób, do którego ma zastosowanie konfiguracja.
- server
- String
Nazwa sieciowa serwera, na którym znajduje się aplikacja sieci Web.
- userToken
-
IntPtr
nativeint
Token konta do użycia.
Zwraca
Obiekt Configuration.
Wyjątki
Parametry server
lub userToken
były nieprawidłowe.
Nie można załadować prawidłowego pliku konfiguracji.
Przykłady
W poniższym przykładzie pokazano, jak uzyskać dostęp do informacji o konfiguracji za OpenWebConfiguration pomocą metody .
// 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
Uwagi
Ta metoda służy do uzyskiwania dostępu do pliku konfiguracji przy użyciu personifikacji.
Uwaga
Token konta jest zwykle pobierany z wystąpienia WindowsIdentity klasy lub za pomocą wywołania niezarządzanego kodu, takiego jak wywołanie interfejsu API LogonUser
systemu Windows. Aby uzyskać więcej informacji o wywołaniach niezarządzanego kodu, zobacz Korzystanie z niezarządzanych funkcji DLL.
Aby uzyskać Configuration obiekt dla zasobu zdalnego, kod musi mieć uprawnienia administracyjne na komputerze zdalnym.
Zobacz też
Dotyczy
OpenWebConfiguration(String, String, String, String, String, String)
Otwiera plik konfiguracji aplikacji internetowej jako Configuration obiekt przy użyciu określonej ścieżki wirtualnej, nazwy lokacji, lokalizacji, serwera i kontekstu zabezpieczeń, aby umożliwić operacje odczytu lub zapisu.
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
Ścieżka wirtualna do pliku konfiguracji.
- site
- String
Nazwa witryny sieci Web aplikacji wyświetlana w konfiguracji usług Internet Information Services (IIS).
- locationSubPath
- String
Określony zasób, do którego ma zastosowanie konfiguracja.
- server
- String
Nazwa sieciowa serwera, na którym znajduje się aplikacja sieci Web.
- userName
- String
Pełna nazwa użytkownika (Domain\User) do użycia podczas otwierania pliku.
- password
- String
Hasło dla nazwy użytkownika.
Zwraca
Obiekt Configuration.
Wyjątki
Parametry server
lub i password
userName
były nieprawidłowe.
Nie można załadować prawidłowego pliku konfiguracji.
Przykłady
W poniższym przykładzie pokazano, jak uzyskać dostęp do informacji o konfiguracji za pomocą OpenWebConfiguration 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
Uwagi
Ta metoda służy do uzyskiwania dostępu do pliku konfiguracji przy użyciu personifikacji.
Aby uzyskać Configuration obiekt dla zasobu zdalnego, kod musi mieć uprawnienia administracyjne na komputerze zdalnym.
Może być konieczne uruchomienie narzędzia rejestracji ASP.NET IIS (Aspnet_regiis.exe) z -config+
opcją włączenia dostępu do plików konfiguracji na komputerze zdalnym.