WebConfigurationManager.OpenWebConfiguration Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Öppnar konfigurationsfilen för webbprogram som ett Configuration objekt.
Överlagringar
| Name | Description |
|---|---|
| OpenWebConfiguration(String) |
Öppnar konfigurationsfilen för webbprogram som ett Configuration objekt med den angivna virtuella sökvägen för att tillåta läs- eller skrivåtgärder. |
| OpenWebConfiguration(String, String) |
Öppnar konfigurationsfilen för webbprogrammet som ett Configuration objekt med den angivna virtuella sökvägen och platsnamnet för att tillåta läs- eller skrivåtgärder. |
| OpenWebConfiguration(String, String, String) |
Öppnar konfigurationsfilen för webbprogram som ett Configuration objekt med den angivna virtuella sökvägen, webbplatsnamnet och platsen för att tillåta läs- eller skrivåtgärder. |
| OpenWebConfiguration(String, String, String, String) |
Öppnar konfigurationsfilen för webbprogrammet som ett Configuration objekt med den angivna virtuella sökvägen, platsnamn, plats och server för att tillåta läs- eller skrivåtgärder. |
| OpenWebConfiguration(String, String, String, String, IntPtr) |
Öppnar konfigurationsfilen för webbprogrammet som ett Configuration objekt med den angivna virtuella sökvägen, platsnamn, plats, server och säkerhetskontext för att tillåta läs- eller skrivåtgärder. |
| OpenWebConfiguration(String, String, String, String, String, String) |
Öppnar konfigurationsfilen för webbprogrammet som ett Configuration objekt med den angivna virtuella sökvägen, platsnamn, plats, server och säkerhetskontext för att tillåta läs- eller skrivåtgärder. |
OpenWebConfiguration(String)
Öppnar konfigurationsfilen för webbprogram som ett Configuration objekt med den angivna virtuella sökvägen för att tillåta läs- eller skrivåtgärder.
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
Parametrar
- path
- String
Den virtuella sökvägen till konfigurationsfilen. Om nullöppnas rotfilen Web.config.
Returer
Ett Configuration objekt.
Undantag
Det gick inte att läsa in en giltig konfigurationsfil.
Exempel
I följande exempel visas hur du kommer åt konfigurationsinformation med OpenWebConfiguration -metoden.
// 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
Kommentarer
Om du vill hämta Configuration objektet för en resurs måste koden ha läsbehörighet för alla konfigurationsfiler som den ärver inställningarna från. Om du vill uppdatera en konfigurationsfil måste koden dessutom ha skrivbehörighet för både konfigurationsfilen och katalogen där den finns.
Se även
Gäller för
OpenWebConfiguration(String, String)
Öppnar konfigurationsfilen för webbprogrammet som ett Configuration objekt med den angivna virtuella sökvägen och platsnamnet för att tillåta läs- eller skrivåtgärder.
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
Parametrar
- path
- String
Den virtuella sökvägen till konfigurationsfilen.
- site
- String
Namnet på programwebbplatsen som visas i konfigurationen Internet Information Services (IIS).
Returer
Ett Configuration objekt.
Undantag
Det gick inte att läsa in en giltig konfigurationsfil.
Exempel
I följande exempel visas hur du kommer åt konfigurationsinformation med OpenWebConfiguration -metoden.
// 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
Kommentarer
Om du vill hämta Configuration objektet för en resurs måste koden ha läsbehörighet för alla konfigurationsfiler som den ärver inställningarna från. Om du vill uppdatera en konfigurationsfil måste koden dessutom ha skrivbehörighet för både konfigurationsfilen och katalogen där den finns.
Se även
Gäller för
OpenWebConfiguration(String, String, String)
Öppnar konfigurationsfilen för webbprogram som ett Configuration objekt med den angivna virtuella sökvägen, webbplatsnamnet och platsen för att tillåta läs- eller skrivåtgärder.
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
Parametrar
- path
- String
Den virtuella sökvägen till konfigurationsfilen.
- site
- String
Namnet på programwebbplatsen som visas i konfigurationen Internet Information Services (IIS).
- locationSubPath
- String
Den specifika resurs som konfigurationen gäller för.
Returer
Ett Configuration objekt.
Undantag
Det gick inte att läsa in en giltig konfigurationsfil.
Exempel
I följande exempel visas hur du kommer åt konfigurationsinformation med OpenWebConfiguration -metoden.
// 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
Kommentarer
Om du vill hämta Configuration objektet för en resurs måste koden ha läsbehörighet för alla konfigurationsfiler som den ärver inställningarna från. Om du vill uppdatera en konfigurationsfil måste koden dessutom ha skrivbehörighet för både konfigurationsfilen och katalogen där den finns.
Se även
Gäller för
OpenWebConfiguration(String, String, String, String)
Öppnar konfigurationsfilen för webbprogrammet som ett Configuration objekt med den angivna virtuella sökvägen, platsnamn, plats och server för att tillåta läs- eller skrivåtgärder.
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
Parametrar
- path
- String
Den virtuella sökvägen till konfigurationsfilen.
- site
- String
Namnet på programwebbplatsen som visas i konfigurationen Internet Information Services (IIS).
- locationSubPath
- String
Den specifika resurs som konfigurationen gäller för.
- server
- String
Nätverksnamnet på servern som webbprogrammet finns på.
Returer
Ett Configuration objekt.
Undantag
Serverparametern var ogiltig.
Det gick inte att läsa in en giltig konfigurationsfil.
Exempel
I följande exempel visas hur du kommer åt konfigurationsinformation med OpenWebConfiguration -metoden.
// 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
Kommentarer
Om du vill hämta Configuration objektet för en fjärrresurs måste koden ha administratörsbehörighet på fjärrdatorn.
Se även
Gäller för
OpenWebConfiguration(String, String, String, String, IntPtr)
Öppnar konfigurationsfilen för webbprogrammet som ett Configuration objekt med den angivna virtuella sökvägen, platsnamn, plats, server och säkerhetskontext för att tillåta läs- eller skrivåtgärder.
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
Parametrar
- path
- String
Den virtuella sökvägen till konfigurationsfilen.
- site
- String
Namnet på programwebbplatsen som visas i konfigurationen Internet Information Services (IIS).
- locationSubPath
- String
Den specifika resurs som konfigurationen gäller för.
- server
- String
Nätverksnamnet på servern som webbprogrammet finns på.
- userToken
-
IntPtr
nativeint
En kontotoken som ska användas.
Returer
Ett Configuration objekt.
Undantag
Parametrarna server eller userToken var ogiltiga.
Det gick inte att läsa in en giltig konfigurationsfil.
Exempel
I följande exempel visas hur du använder OpenWebConfiguration metoden för att komma åt konfigurationsinformation.
// 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
Kommentarer
Den här metoden används för att komma åt en konfigurationsfil med personifiering.
Note
Kontotoken hämtas vanligtvis från en instans av klassen WindowsIdentity eller via ett anrop till ohanterad kod, till exempel ett anrop till Windows API LogonUser. Mer information om anrop till ohanterad kod finns i Använda ohanterade DLL-funktioner.
Om du vill hämta Configuration objektet för en fjärrresurs måste koden ha administratörsbehörighet på fjärrdatorn.
Se även
Gäller för
OpenWebConfiguration(String, String, String, String, String, String)
Öppnar konfigurationsfilen för webbprogrammet som ett Configuration objekt med den angivna virtuella sökvägen, platsnamn, plats, server och säkerhetskontext för att tillåta läs- eller skrivåtgärder.
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
Parametrar
- path
- String
Den virtuella sökvägen till konfigurationsfilen.
- site
- String
Namnet på programwebbplatsen som visas i konfigurationen Internet Information Services (IIS).
- locationSubPath
- String
Den specifika resurs som konfigurationen gäller för.
- server
- String
Nätverksnamnet på servern som webbprogrammet finns på.
- userName
- String
Det fullständiga användarnamnet (domän\användare) som ska användas när filen öppnas.
- password
- String
Lösenordet för användarnamnet.
Returer
Ett Configuration objekt.
Undantag
Parametrarna server eller userName och password var ogiltiga.
Det gick inte att läsa in en giltig konfigurationsfil.
Exempel
I följande exempel visas hur du kommer åt konfigurationsinformation med OpenWebConfiguration -metoden.
// 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
Kommentarer
Den här metoden används för att komma åt en konfigurationsfil med personifiering.
Om du vill hämta Configuration objektet för en fjärrresurs måste koden ha administratörsbehörighet på fjärrdatorn.
Du kan behöva köra ASP.NET IIS-registreringsverktyget (Aspnet_regiis.exe) med alternativet -config+ för att ge åtkomst till konfigurationsfilerna på fjärrdatorn.