QueryInterceptorAttribute 類別

定義

命名空間:

System.Data.Services

組件:

System.Data.Services.dll

方法上的 QueryInterceptorAttribute 會將它標註為指定之實體集上的查詢攔截器。

public ref class QueryInterceptorAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Method, AllowMultiple=true, Inherited=true)]
public sealed class QueryInterceptorAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Method, AllowMultiple=true, Inherited=true)>]
type QueryInterceptorAttribute = class
    inherit Attribute

Public NotInheritable Class QueryInterceptorAttribute
Inherits Attribute

繼承

Object

Attribute

QueryInterceptorAttribute

屬性

AttributeUsageAttribute

範例

下列範例會控制實體集的存取權 Customers 。 每個都只能 Customer 看到 Orders 相關聯的 Customer 。

[QueryInterceptor("Orders")]  
public Expression<Func<Order, bool>> FilterOrders()   
{  
    return o => o.Customer.Name == /* Current principal name. */;  
}   

// Insures that the user accessing the customer(s) has the appropriate  
// rights as defined in the QueryRules object to access the customer  
// resource(s).  

[QueryInterceptor ("Customers")]  
public Expression<Func<Customer, bool>> FilterCustomers()   
{  
  return c => c.Name == /* Current principal name. */ &&  
              this.CurrentDataSource.QueryRules.Contains(  
                rule => rule.Name == c.Name &&  
                        rule.CustomerAllowedToQuery == true  
              );  
}  

備註

實體集層級授權和驗證是由標注的方法所執行 QueryInterceptorAttribute 。 WCF 資料 Servicess 不會執行安全性原則，而是提供服務開發人員撰寫自己的安全性規則和商務驗證所需的基礎結構。

實體集存取控制和驗證是透過查詢作業使用查詢組合來啟用。 若要控制以實體為基礎的存取，根據下列規則來執行每個實體的方法設定：

方法必須具有公用範圍，並以 QueryInterceptorAttribute 實體集的名稱做為參數，以將其加上批註。

方法不能接受任何參數。

方法必須傳回型別為的運算式 Expression<Func<T, bool>> ，此運算式為實體集所要組成的篩選準則。

建構函式

QueryInterceptorAttribute(String)

初始化 entitySetName 參數指定的實體集之 QueryInterceptorAttribute 類別的新執行個體。

屬性

EntitySetName	取得包含要套用攔截器之實體的實體集名稱。
TypeId	在衍生類別中實作時，取得這個 Attribute 的唯一識別碼。 (繼承來源 Attribute)

方法

Equals(Object)	傳回值，這個值指出此執行個體是否與指定的物件相等。 (繼承來源 Attribute)
GetHashCode()	傳回這個執行個體的雜湊碼。 (繼承來源 Attribute)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
IsDefaultAttribute()	在衍生類別中覆寫時，表示這個執行個體的值是衍生類別的預設值。 (繼承來源 Attribute)
Match(Object)	在衍生類別中覆寫時，會傳回值，表示這個執行個體是否等於指定物件。 (繼承來源 Attribute)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

明確介面實作

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	將一組名稱對應至一組對應的分派識別項 (Dispatch Identifier)。 (繼承來源 Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	擷取物件的類型資訊，可以用來取得介面的類型資訊。 (繼承來源 Attribute)
_Attribute.GetTypeInfoCount(UInt32)	擷取物件提供的類型資訊介面數目 (0 或 1)。 (繼承來源 Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	提供物件所公開的屬性和方法的存取權。 (繼承來源 Attribute)