HOW TO：透過用戶端應用程式服務存取使用者設定

發行項
08/12/2011

您可以使用用戶端應用程式服務，從現有 Microsoft AJAX 設定檔服務擷取使用者應用程式設定。用戶端應用程式服務 Web 設定功能會整合 .NET Framework 2.0 中提供的應用程式設定功能。如需應用程式設定的詳細資訊，請參閱應用程式設定概觀。如需如何設定 Microsoft AJAX 設定檔服務的詳細資訊，請參閱搭配 Microsoft Ajax 使用設定檔資訊。

下列程序會描述如何在應用程式設定為 Web 設定服務時，存取使用者 Web 設定。如需詳細資訊，請參閱 HOW TO：設定用戶端應用程式服務。這個程序需要存取執行中的 Microsoft AJAX 設定檔服務。如需端對端測試用戶端應用程式服務功能，請參閱逐步解說：使用用戶端應用程式服務。

在 Windows 用戶端應用程式中存取 Web 設定

請確定應用程式已正確設定為使用用戶端應用程式服務，如 HOW TO：設定用戶端應用程式服務中所述。您最少必須在專案設計工具的 [服務] 頁面上指定 Web 設定服務位置。若要擷取設定為讓已驗證之使用者使用的 Web 設定，您也必須指定驗證服務位置或使用 Windows 驗證。
在專案設計工具的 [設定] 頁面上，按一下 [載入 Web 設定]。

[登入] 對話方塊隨即出現。

若要擷取在伺服器上設定為讓所有已驗證之使用者使用的設定，請指定有效的使用者認證，然後按一下 [登入]。若要擷取設定為讓所有匿名使用者使用的設定，請按一下 [略過登入]。

伺服器上的設定隨即出現在設計工具中。此外，也會產生或更新 Settings 類別 (在 C# 中當做 Properties.Settings.Default 存取，而在 Visual Basic 中當做 My.Settings 存取)，以便包含以設定為基礎的屬性。這個類別會透過 ClientSettingsProvider 類別管理與遠端 Web 設定服務的所有互動。雖然您可以直接存取 ClientSettingsProvider 類別，但是通常會透過 Settings 類別以間接的方式存取，如下一個步驟所示。如需詳細資訊，請參閱用戶端應用程式服務概觀。

注意事項
您無法使用 [設定] 頁面修改預設 Web 設定值，也無法存取非預設值。此外，如果修改伺服器上的預設值，您必須按一下 [載入 Web 設定] 按鈕以擷取新的預設值。用戶端應用程式服務不會使用 [同步] 按鈕。

在應用程式程式碼中，請使用已產生之類別的屬性取得或設定 Web 設定值。

下列程式碼範例假設您已擷取名為 MySetting 的設定，並且應用程式包含名為 myLabel 的 Label。
```
My.Settings.MySetting = "test"
myLabel.Text = My.Settings.MySetting
```
```
Properties.Settings.Default.MySetting = "test";
myLabel.Text = Properties.Settings.Default.MySetting;
```
在應用程式程式碼中，請使用 ApplicationSettingsBase.Save 方法將變更過的設定值儲存回 Web 設定服務。
```
My.Settings.Save()
```
```
Properties.Settings.Default.Save();
```

穩固程式設計

這個主題中的範例程式碼會示範 Windows 用戶端應用程式中 Web 設定的最簡單用法。但是當您透過用戶端應用程式服務存取或儲存 Web 設定時，程式碼可能會擲回 WebException。這表示服務無法使用或使用者登入已逾期。如需如何處理上述情形中的 WebException 範例，請參閱逐步解說：使用用戶端應用程式服務。

請參閱

共用方式為

HOW TO：透過用戶端應用程式服務存取使用者設定

在 Windows 用戶端應用程式中存取 Web 設定

穩固程式設計

請參閱

工作

參考

概念

其他資源

其他資源