QueryAttribute 類別

發行項
03/18/2011

指定 DomainService 方法是查詢方法。

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

使用方式

'用途
Dim instance As QueryAttribute

語法

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

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

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

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

AttributeUsageAttribute(AttributeTargets.Method|AttributeTargets.Property|AttributeTargets.Field, AllowMultiple=false, Inherited=true) 
public final class QueryAttribute extends Attribute

備註

您將 QueryAttribute 屬性套用至方法，即可表示該方法是查詢方法，或是為查詢方法指定特定值。如果您的方法符合查詢方法預期的方法簽章，就不必套用 QueryAttribute。RIA Services 架構會推斷，具有預期之查詢簽章的方法應該視為查詢。您將 IgnoreAttribute 套用至方法，即可避免 RIA Services 架構針對該方法產生網域作業。

以下將示範查詢方法的預期簽章：

傳回值	`IEnumerable<T>`、`IQueryable<T>` 或實體
參數	任何數字
名稱前置詞	任何名稱
屬性	`[Query]` (C#) -或- `<Query()>` (Visual Basic)
範例	`public IQueryable<Product> GetProducts()` (C#) -或- `Public Function GetProducts() As IQueryable(Of Product)` (Visual Basic)

QueryAttribute 類別可讓您設定處理查詢要求時使用的值。您可以設定 ResultLimit 屬性來限制針對某個查詢傳回的記錄數目。您可能想要設定這個值，以避免使用者使用大量查詢要求造成伺服器的負擔。如需詳細資訊，請參閱 Security for WCF RIA Services。IsComposable 屬性可讓您指定，用戶端專案中的程式碼是否可以透過在新查詢內使用查詢方法來修改查詢的結果。例如，當 IsComposable 為 true 時，您可以在伺服器上將用戶端程式碼中的 Where 子句加入至查詢，以便傳回資料庫資料表的所有記錄。

繼承階層

System.Object
System.Attribute
System.ServiceModel.DomainServices.Server.QueryAttribute

執行緒安全性

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

平台

開發平台

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

目標平台

另請參閱

參考

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

共用方式為