HOW TO：啟用 RIA Services 中的設定檔

本主題將示範如何在先前已經啟用驗證的情況下，啟用 WCF RIA Services 方案中的設定檔。設定檔可用來擷取及儲存使用者的屬性。RIA Services 中的設定檔是以 ASP.NET 中的設定檔架構為建置基礎。如需 ASP.NET 設定檔的詳細資訊，請參閱 ASP.NET 設定檔屬性概觀。

只有在使用者經過驗證之後，您才能擷取或儲存使用者設定檔屬性。若要設定伺服器和用戶端專案進行驗證，請參閱 HOW TO：啟用 RIA Services 中的驗證。

若要設定伺服器專案

1. 在伺服器專案中，開啟 Web.config 檔案。

2. 在 <system.web> 區段中加入 <profile> 項目。

3. 在 <profile> 項目加入設定檔屬性。

   下列範例示範如何啟用設定檔並與定義一個名為 FriendlyName 的屬性。

   <system.web>
     <authentication mode="Forms"></authentication>
     <profile enabled="true">
       <properties>
         <add name="FriendlyName"/>
       </properties>
     </profile>
   </system.web>
   

4. 開啟包含驗證服務之 User 類別的檔案。

5. 在 User類別中加入所有已加入 Web.config 檔案中的設定檔屬性。

   下列範例示範如何加入一個名為 FriendlyName 屬性，比對已加入 Web.config 檔案中的屬性。

   Public Partial Class User
       Inherits UserBase
   
       Private _FriendlyName As String
   
       Public Property FriendlyName() As String
           Get
               Return _FriendlyName
           End Get
           Set(ByVal value As String)
               _FriendlyName = value
           End Set
       End Property
   End Class
   

   public partial class User : UserBase
   {
       public string FriendlyName { get; set; }
   }
   

若要從用戶端專案存取設定檔屬性

1. 在 Silverlight 用戶端專案中，開啟程式碼後置頁面。

2. 在程式碼後置頁面中，設定或擷取目前 WebContext 執行個體之 User 物件上的設定檔屬性。

   下列程式碼範例示範如何在程式碼後置檔案中設定一個設定檔屬性。

   WebContext.Current.User.FriendlyName = "Mike"
   

   WebContext.Current.User.FriendlyName = "Mike";
   

3. 如果您想要讓 WebContext 物件可以在 XAML 中使用，請將目前的 WebContext 執行個體加入至 Application.Startup 事件中的應用程式資源，然後再建立根 Visual。

   下列範例示範如何加入 WebContext 執行個體做為應用程式資源。

   Private Sub Application_Startup(ByVal o As Object, ByVal e As StartupEventArgs) Handles Me.Startup
       Me.Resources.Add("WebContext", WebContext.Current)
       Me.RootVisual = New MainPage()
   End Sub
   

   private void Application_Startup(object sender, StartupEventArgs e)
   {
       this.Resources.Add("WebContext", WebContext.Current);
       this.RootVisual = new MainPage();
   }
   

   宣告式語法可用來擷取設定檔屬性。下列範例示範如何以 XAML 擷取設定檔屬性。

   <TextBlock Text={Binding Source={StaticResource WebContext}, Path=User.FriendlyName}"/>
   

另請參閱

工作

逐步解說：搭配 Silverlight 瀏覽應用程式使用驗證服務
逐步解說：搭配 Silverlight 商務應用程式使用驗證服務