WebConfigurationManager 類別

定義

public ref class WebConfigurationManager abstract sealed

public static class WebConfigurationManager

type WebConfigurationManager = class

Public Class WebConfigurationManager

繼承

Object

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 一種方法來撰寫組態資訊。 請注意，寫入的使用者或進程必須具有下列許可權：

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

• 所有組態檔的讀取權限。

屬性

方法

適用於

另請參閱

• Configuration
• ConfigurationManager
• ASP.NET 組態概觀