共用方式為


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

更新:2007 年 11 月

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

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

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

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

  2. 在專案設計工具的 [設定] 頁面上,按一下 [載入 Web 設定]。

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

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

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

    注意事項:

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

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

    下列程式碼範例假設您已擷取名為 MySetting 的設定,並且應用程式包含名為 myLabel 的 Label

    My.Settings.MySetting = "test"
    myLabel.Text = My.Settings.MySetting
    
    Properties.Settings.Default.MySetting = "test";
    myLabel.Text = Properties.Settings.Default.MySetting;
    
  5. 在應用程式程式碼中,請使用 ApplicationSettingsBase.Save 方法將變更過的設定值儲存回 Web 設定服務。

    My.Settings.Save()
    
    Properties.Settings.Default.Save();
    

穩固程式設計

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

請參閱

工作

HOW TO:設定用戶端應用程式服務

逐步解說:使用用戶端應用程式服務

HOW TO:建立應用程式設定

概念

用戶端應用程式服務概觀

搭配 ASP.NET AJAX 使用設定檔資訊

應用程式設定概觀

參考

ClientSettingsProvider

ApplicationSettingsBase

ApplicationSettingsBase.Save

其他資源

用戶端應用程式服務

管理應用程式設定