共用方式為


WebConfigurationManager 類別

定義

在將組態檔套用至 Web 應用程式時提供對它們的存取權。

public ref class WebConfigurationManager abstract sealed
public static class WebConfigurationManager
type WebConfigurationManager = class
Public Class WebConfigurationManager
繼承
WebConfigurationManager

範例

下列範例示範如何使用 存取組態資訊

GetSection 方法。


// Show how to use the GetSection(string). 
// to access the connectionStrings section.
static void GetConnectionStringsSection()
{

    // Get the connectionStrings section.
    ConnectionStringsSection connectionStringsSection =
        WebConfigurationManager.GetSection("connectionStrings")
        as ConnectionStringsSection;

    // Get the connectionStrings key,value pairs collection.
    ConnectionStringSettingsCollection connectionStrings =
        connectionStringsSection.ConnectionStrings;
   
    // Get the collection enumerator.
    IEnumerator connectionStringsEnum =
        connectionStrings.GetEnumerator();

    // Loop through the collection and 
    // display the connectionStrings key, value pairs.
    int i = 0;
    Console.WriteLine("[Display the connectionStrings]");
    while (connectionStringsEnum.MoveNext())
    {
        string name = connectionStrings[i].Name;
        Console.WriteLine("Name: {0} Value: {1}",
        name, connectionStrings[name]);
        i += 1;
    }

    Console.WriteLine();
}
' Show how to use the GetSection(string). 
' to access the connectionStrings section.
Shared Sub GetConnectionStringsSection()
   
   ' Get the connectionStrings section.
     Dim connectionStringsSection As ConnectionStringsSection = _
     WebConfigurationManager.GetSection("connectionStrings")
   
   ' Get the connectionStrings key,value pairs collection.
     Dim connectionStrings As ConnectionStringSettingsCollection = _
     connectionStringsSection.ConnectionStrings
   
   ' Get the collection enumerator.
     Dim connectionStringsEnum As IEnumerator = _
     connectionStrings.GetEnumerator()
   
   ' Loop through the collection and 
   ' display the connectionStrings key, value pairs.
   Dim i As Integer = 0
   Console.WriteLine("[Display the connectionStrings]")
   While connectionStringsEnum.MoveNext()
      Dim name As String = connectionStrings(i).Name
         Console.WriteLine("Name: {0} Value: {1}", _
         name, connectionStrings(name))
      i += 1
   End While
   
   Console.WriteLine()
End Sub

備註

類別 WebConfigurationManager 可讓您存取計算機和應用程式資訊。

使用 WebConfigurationManager 是處理 Web 應用程式相關組態檔的慣用方式。 針對用戶端應用程式,請使用 ConfigurationManager 類別。

您的應用程式可以擴充 System.Configuration 類型,或使用它們直接處理組態資訊,如下列清單所述:

給繼承者的注意事項

類別 Configuration 允許以程式設計方式存取編輯組態檔。 您可以使用 提供的 WebConfigurationManager其中一個開啟方法。 這些方法會傳回 Configuration 物件,接著會提供必要的方法和屬性來處理基礎組態檔。 您可以存取這些檔案來讀取或寫入,如下所示:

GetSection(String)您可以使用 或 GetSectionGroup(String) 讀取組態資訊。 請注意,讀取的使用者或進程必須具有下列許可權:

  • 目前組態階層層級之組態檔的讀取許可權。

  • 所有父組態檔的讀取許可權。

如果您的應用程式需要只讀存取自己的設定,建議您使用 GetSection 方法。 這些方法提供目前應用程式的快取組態值存取權,其效能優於 Configuration 類別。

注意:如果您使用採用path參數的靜態GetSection方法,path 參數必須參考執行程式碼的應用程式;否則會忽略 參數,並傳回目前執行之應用程式的組態資訊。

您可以使用其中 Save 一種方法來撰寫組態資訊。 請注意,寫入的使用者或進程必須具有下列許可權:

  • 目前組態階層層級之組態檔和目錄的寫入許可權。

  • 所有組態檔的讀取許可權。

屬性

AppSettings

取得網站的應用程式設定。

ConnectionStrings

取得網站的連接字串。

方法

GetSection(String)

從目前 Web 應用程式的組態檔中擷取指定的組態區段。

GetSection(String, String)

在指定的位置從 Web 應用程式的組態檔擷取指定的組態區段。

GetWebApplicationSection(String)

從目前 Web 應用程式的組態檔中擷取指定的組態區段。

OpenMachineConfiguration()

開啟目前電腦上的電腦組態檔做為 Configuration 物件,以允許讀取或寫入作業。

OpenMachineConfiguration(String)

開啟目前電腦上的電腦組態檔做為 Configuration 物件,以允許讀取或寫入作業。

OpenMachineConfiguration(String, String)

開啟指定伺服器上的指定電腦組態檔做為 Configuration 物件,以允許讀取或寫入作業。

OpenMachineConfiguration(String, String, IntPtr)

使用指定的安全性內容,開啟指定伺服器上的指定電腦組態檔做為 Configuration 物件,以允許讀取或寫入作業。

OpenMachineConfiguration(String, String, String, String)

使用指定的安全性內容,開啟指定伺服器上的指定電腦組態檔做為 Configuration 物件,以允許讀取或寫入作業。

OpenMappedMachineConfiguration(ConfigurationFileMap)

使用指定的檔案對應,開啟電腦組態檔做為 Configuration 物件,以允許讀取或寫入作業。

OpenMappedMachineConfiguration(ConfigurationFileMap, String)

使用指定的檔案對應和位置,開啟電腦組態檔做為 Configuration 物件,以允許讀取或寫入作業。

OpenMappedWebConfiguration(WebConfigurationFileMap, String)

使用指定的檔案對應和虛擬路徑,開啟指定的 Web 應用程式組態檔做為 Configuration 物件,以允許讀取或寫入作業。

OpenMappedWebConfiguration(WebConfigurationFileMap, String, String)

使用指定的檔案對應、虛擬路徑和網站名稱,開啟指定的 Web 應用程式組態檔做為 Configuration 物件,以允許讀取或寫入作業。

OpenMappedWebConfiguration(WebConfigurationFileMap, String, String, String)

使用指定的檔案對應、虛擬路徑、網站名稱和位置,開啟指定的 Web 應用程式組態檔做為 Configuration 物件,以允許讀取或寫入作業。

OpenWebConfiguration(String)

使用指定的虛擬路徑,開啟 Web 應用程式組態檔做為 Configuration 物件,以允許讀取或寫入作業。

OpenWebConfiguration(String, String)

使用指定的虛擬路徑和網站名稱,開啟 Web 應用程式組態檔做為 Configuration 物件,以允許讀取或寫入作業。

OpenWebConfiguration(String, String, String)

使用指定的虛擬路徑、網站名稱和位置,開啟 Web 應用程式組態檔做為 Configuration 物件,以允許讀取或寫入作業。

OpenWebConfiguration(String, String, String, String)

使用指定的虛擬路徑、網站名稱、位置和伺服器,開啟 Web 應用程式組態檔做為 Configuration 物件,以允許讀取或寫入作業。

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

使用指定的虛擬路徑、網站名稱、位置、伺服器和安全性內容,開啟 Web 應用程式組態檔做為 Configuration 物件,以允許讀取或寫入作業。

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

使用指定的虛擬路徑、網站名稱、位置、伺服器和安全性內容,開啟 Web 應用程式組態檔做為 Configuration 物件,以允許讀取或寫入作業。

適用於

另請參閱