RequiresAuthenticationAttribute 類別

發行項
03/18/2011

指定網域作業只能由驗證的使用者叫用。

命名空間: System.ServiceModel.DomainServices.Server
組件: System.ServiceModel.DomainServices.Server (於 system.servicemodel.domainservices.server.dll)

使用方式

'用途
Dim instance As RequiresAuthenticationAttribute

語法

'宣告
<AttributeUsageAttribute(AttributeTargets.Class Or AttributeTargets.Method Or AttributeTargets.Property Or AttributeTargets.Field, AllowMultiple:=False, Inherited:=True)> _
Public NotInheritable Class RequiresAuthenticationAttribute
    Inherits AuthorizationAttribute

[AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Method|AttributeTargets.Property|AttributeTargets.Field, AllowMultiple=false, Inherited=true)] 
public sealed class RequiresAuthenticationAttribute : AuthorizationAttribute

[AttributeUsageAttribute(AttributeTargets::Class|AttributeTargets::Method|AttributeTargets::Property|AttributeTargets::Field, AllowMultiple=false, Inherited=true)] 
public ref class RequiresAuthenticationAttribute sealed : public AuthorizationAttribute

/** @attribute AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Method|AttributeTargets.Property|AttributeTargets.Field, AllowMultiple=false, Inherited=true) */ 
public final class RequiresAuthenticationAttribute extends AuthorizationAttribute

AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Method|AttributeTargets.Property|AttributeTargets.Field, AllowMultiple=false, Inherited=true) 
public final class RequiresAuthenticationAttribute extends AuthorizationAttribute

範例

下列範例會示範網域服務，其中 RequiresAuthenticationAttribute 屬性已套用至 GetSalesOrderHeader 方法。

<EnableClientAccess()>  _
Public Class AdventureWorksDomainService
    Inherits LinqToEntitiesDomainService(Of AdventureWorksLT_DataEntities)

    <RequiresRole("Managers")> _
    Public Function GetCustomers() As IQueryable(Of Customer)
        Return Me.ObjectContext.Customers
    End Function
    
    Public Function GetProducts() As IQueryable(Of Product)
        Return Me.ObjectContext.Products
    End Function

    <RequiresAuthentication()> _
    Public Function GetSalesOrderHeaders() As IQueryable(Of SalesOrderHeader)
        Return Me.ObjectContext.SalesOrderHeaders
    End Function
End Class

[EnableClientAccess()]
public class AdventureWorksDomainService : LinqToEntitiesDomainService<AdventureWorksLT_DataEntities>
{
    [RequiresRole("Managers")]
    public IQueryable<Customer> GetCustomers()
    {
        return this.ObjectContext.Customers;
    }
 
    public IQueryable<Product> GetProducts()
    {
        return this.ObjectContext.Products;
    }

    [RequiresAuthentication()]
    public IQueryable<SalesOrderHeader> GetSalesOrderHeaders()
    {
        return this.ObjectContext.SalesOrderHeaders;
    }
}

備註

您將 RequiresAuthenticationAttribute 屬性套用至網域方法，即可限制只有經過驗證的使用者才能存取作業。當您將 RequiresAuthenticationAttribute 屬性套用至整個網域服務類別時，所有網域作業都會限制只有經過驗證的使用者才能執行。若使用者未經驗證，RequiresAuthenticationAttribute 屬性就會避免執行該方法。如果您在使用者未驗證時呼叫網域作業，網域作業就會傳回例外狀況。您可以在呼叫網域作業之前，先檢查用戶端專案中所產生 User 物件上的 IsAuthenticated 屬性，以避免這種情況發生。

RIA Services 同時提供 RequiresRoleAttribute 屬性，指出使用者必須屬於指定的角色。您也可以提供自訂的授權需求，方法是實作衍生自 AuthorizationAttribute 的類別並覆寫 IsAuthorized 方法。如需詳細資訊，請參閱 How to: Create a Custom Authorization Attribute。

繼承階層

System.Object
   System.Attribute
     System.ComponentModel.DataAnnotations.AuthorizationAttribute
      System.ServiceModel.DomainServices.Server.RequiresAuthenticationAttribute

執行緒安全性

任何這個類型的公用靜態 (在 Visual Basic 中為共用) 成員都具備執行緒安全。不保證任何執行個體成員安全執行緒。

平台

開發平台

Windows XP Home Edition, Windows XP Professional, Windows Server 2003 、Windows Server 2008 和 Windows 2000

目標平台

Change History

另請參閱

參考

RequiresAuthenticationAttribute 成員
 System.ServiceModel.DomainServices.Server 命名空間

共用方式為