WebConfigurationManager 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
在將組態檔套用至 Web 應用程式時提供對它們的存取權。
public ref class WebConfigurationManager abstract sealedpublic static class WebConfigurationManagertype WebConfigurationManager = classPublic 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 類型，或使用它們直接處理組態資訊，如下列清單所述：
Handling configuration. 若要使用標準類型來處理組態資訊，請使用下列其中一種方法：Accessing a section. 若要存取應用程式的組態資訊，您必須使用 所提供的WebConfigurationManager其中GetSection一種方法。 針對<appSettings>和<connectionStrings>，您可以使用 AppSettings 和 ConnectionStrings 屬性。 這些方法會執行只讀作業、使用組態的單一快取實例，並感知多線程。Accessing configuration files. 您的應用程式可以在任何層級、本身或其他應用程式或計算機、本機或遠端讀取和寫入組態設定。 您可以使用 所提供的WebConfigurationManager其中open一種方法。 這些方法會傳回 Configuration 物件，接著會提供必要的方法和屬性來處理基礎組態檔。 這些方法會執行讀取或寫入作業，並在每次開啟檔案時重新建立組態數據。Advanced configuration. 更進階的組態處理是由、PropertyInformation、、PropertyInformationCollection、ElementInformation、 ContextInformationConfigurationSectionGroup和ConfigurationSectionGroupCollection類型SectionInformation所提供。
Extending configuration standard types. 您也可以使用程式設計或屬性化模型來擴充標準組態類型，例如 ConfigurationElement、 ConfigurationElementCollection、 ConfigurationProperty和 ConfigurationSection 來提供自定義組態專案。 ConfigurationSection如需如何以程式設計方式擴充標準組態類型的範例，請參閱 類別。 ConfigurationElement如需如何使用屬性模型擴充標準組態類型的範例，請參閱 類別。
給繼承者的注意事項
類別 Configuration 允許以程式設計方式存取編輯組態檔。 您可以使用 提供的 WebConfigurationManager其中一個開啟方法。 這些方法會傳回 Configuration 物件，接著會提供必要的方法和屬性來處理基礎組態檔。 您可以存取這些檔案來讀取或寫入，如下所示：
GetSection(String)您可以使用 或 GetSectionGroup(String) 讀取組態資訊。 請注意，讀取的使用者或進程必須具有下列許可權：
目前組態階層層級之組態檔的讀取許可權。
所有父組態檔的讀取許可權。
如果您的應用程式需要只讀存取自己的設定，建議您使用 GetSection 方法。 這些方法提供目前應用程式的快取組態值存取權，其效能優於 Configuration 類別。
注意：如果您使用採用path參數的靜態GetSection方法，path 參數必須參考執行程式碼的應用程式;否則會忽略 參數，並傳回目前執行之應用程式的組態資訊。
您可以使用其中 Save 一種方法來撰寫組態資訊。 請注意，寫入的使用者或進程必須具有下列許可權：
目前組態階層層級之組態檔和目錄的寫入許可權。
所有組態檔的讀取許可權。
屬性
| AppSettings |
取得網站的應用程式設定。 |
| ConnectionStrings |
取得網站的連接字串。 |
