如何:讀取應用程式設定
注意
本文專屬於 .NET Framework。 其不適用於較新的 .NET 實作,包括 .NET 6 和更新版本。
本文說明如何在 .NET Framework 應用程式將簡單的設定加入 App.config 檔案,然後以程式設計方式讀取值。 可讀取整個區段或整個檔案,而不僅僅讀取單一值。 如需更多範例與資訊,請參閱 ConfigurationManager 文件。
新增 App.config 檔案
Visual Studio 可讓您輕鬆將 App.config 檔案加入專案。 在建立 .NET Framework 專案之後,以滑鼠右鍵按一下 [方案總管] 的專案,然後選擇 [新增]>[新項目]。 選取 [應用程式組態檔] 項目,然後選取 [新增]。
加入設定
開啟 App.config 檔案,並在 <configuration>
元素新增下列 XML。
<appSettings>
<add key="occupation" value="dentist"/>
</appSettings>
以程式設計方式存取設定
若要在程式碼存取設定的值,請透過索引到 AppSettings 屬性來取得值。 AppSettings 屬性可讓您輕鬆從組態檔的 <appSettings>
元素取得資料。
string occupation = ConfigurationManager.AppSettings["occupation"];
程式庫的組態
雖然針對可執行檔應用程式使用組態檔相當簡單,但對於類別庫而言則會稍微複雜一點。 類別庫可以採用與可執行應用程式相同的方式存取組態設定,不過,組態設定必須存在於用戶端應用程式的 App.config 檔案。 即使將 App.config 檔案與程式庫的組態檔一起散發 ,程式庫程式碼也不會讀取檔案。 或者,請考慮下列在類別庫使用組態設定的方式:
- 取得用戶端應用程式的組態設定,並將其傳遞至要從類別庫實例化的類別。
- 實作擴充 ConfigurationSection 類別的自訂區段類型。 保留類別庫的個別組態檔,然後從用戶端應用程式的組態檔參考程式庫的組態檔。 如需詳細資訊,請參閱如何:使用 ConfigurationSection 建立自訂群組態區段。