WebInvokeAttribute 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
代表屬性，這個屬性表示服務作業在邏輯上為叫用作業，可由 WCF REST 程式設計模型呼叫。
public ref class WebInvokeAttribute sealed : Attribute, System::ServiceModel::Description::IOperationBehavior[System.AttributeUsage(System.AttributeTargets.Method)]
public sealed class WebInvokeAttribute : Attribute, System.ServiceModel.Description.IOperationBehavior[<System.AttributeUsage(System.AttributeTargets.Method)>]
type WebInvokeAttribute = class
inherit Attribute
interface IOperationBehaviorPublic NotInheritable Class WebInvokeAttribute
Inherits Attribute
Implements IOperationBehavior- 繼承
- 屬性
- 實作
範例
下列範例會示範如何使用 WebInvokeAttribute 屬性。
注意
由於下列程式碼並未指定 Method 屬性，因此會將所有的服務作業對應至 HTTP POST 方法。
[ServiceContract]
public interface ICalculator2
{
[OperationContract]
[WebInvoke]
long Add(long x, long y);
[OperationContract]
[WebInvoke(UriTemplate = "Sub?x={x}&y={y}")]
long Subtract(long x, long y);
[OperationContract]
[WebInvoke(UriTemplate = "Mult?x={x}&y={y}", BodyStyle = WebMessageBodyStyle.Bare)]
long Multiply(long x, long y);
[OperationContract]
[WebInvoke(UriTemplate = "Div?x={x}&y={y}", BodyStyle = WebMessageBodyStyle.Bare, RequestFormat = WebMessageFormat.Xml, ResponseFormat=WebMessageFormat.Xml)]
long Divide(long x, long y);
[OperationContract]
[WebInvoke(Method = "POST", UriTemplate = "Mod?x={x}&y={y}")]
long Mod(long x, long y);
}
<ServiceContract()> _
Public Interface ICalculator2
<OperationContract()> _
<WebInvoke()> _
Function Add(ByVal x As Long, ByVal y As Long) As Long
<OperationContract()> _
<WebInvoke(UriTemplate:="Sub?x={x}&y={y}")> _
Function Subtract(ByVal x As Long, ByVal y As Long) As Long
<OperationContract()> _
<WebInvoke(UriTemplate:="Mult?x={x}&y={y}", BodyStyle:=WebMessageBodyStyle.Bare)> _
Function Multiply(ByVal x As Long, ByVal y As Long) As Long
<OperationContract()> _
<WebInvoke(UriTemplate:="Div?x={x}&y={y}", BodyStyle:=WebMessageBodyStyle.Bare, RequestFormat:=WebMessageFormat.Xml, ResponseFormat:=WebMessageFormat.Xml)> _
Function Divide(ByVal x As Long, ByVal y As Long) As Long
<OperationContract()> _
<WebInvoke(Method:="POST", UriTemplate:="Mod?x={x}&y={y}")> _
Function Modulo(ByVal x As Long, ByVal y As Long) As Long
End Interface
備註
除了 WebInvokeAttribute 之外，還對服務作業套用 OperationContractAttribute 屬性，並且將作業與 UriTemplate 以及表示叫用的基礎傳輸動詞 (例如，HTTP POST、PUT 或 DELETE) 產生關聯。 屬性 WebInvokeAttribute 是 被動 作業行為， (IOperationBehavior 方法不會執行任何動作，) 將中繼資料新增至作業描述。 套用 WebInvokeAttribute 屬性至服務作業並不會起作用，除非在作業描述 (例如 WebHttpBehavior) 中尋找此中繼資料的行為，已新增至服務的行為集合中。 WebInvokeAttribute 可決定服務作業所回應的 HTTP 方法。 根據預設，已套用 WebInvokeAttribute 的所有方法都會回應 POST 要求。 Method 屬性可讓您指定不同的 HTTP 方法。 如果您要服務作業回應 GET，請改為使用 WebGetAttribute。
建構函式
| WebInvokeAttribute() |
初始化 WebInvokeAttribute 類別的新執行個體。 |
屬性
| BodyStyle |
取得或設定於服務作業來回傳送的訊息本文樣式。 |
| IsBodyStyleSetExplicitly |
取得 IsBodyStyleSetExplicitly 屬性。 |
| IsRequestFormatSetExplicitly |
取得 IsRequestFormatSetExplicitly 屬性。 |
| IsResponseFormatSetExplicitly | |
| Method |
取得或設定服務作業回應的通訊協定 (例如 HTTP) 方法。 |
| RequestFormat |
取得或設定 RequestFormat 屬性。 |
| ResponseFormat |
取得或設定 ResponseFormat 屬性。 |
| TypeId |
在衍生類別中實作時，取得這個 Attribute 的唯一識別碼。 (繼承來源 Attribute) |
| UriTemplate |
服務作業的統一資源識別元 (URI) 範本。 |
方法
| Equals(Object) |
傳回值，這個值指出此執行個體是否與指定的物件相等。 (繼承來源 Attribute) |
| GetHashCode() |
傳回這個執行個體的雜湊碼。 (繼承來源 Attribute) |
| GetType() |
取得目前執行個體的 Type。 (繼承來源 Object) |
| IsDefaultAttribute() |
在衍生類別中覆寫時，表示這個執行個體的值是衍生類別的預設值。 (繼承來源 Attribute) |
| Match(Object) |
在衍生類別中覆寫時，會傳回值，表示這個執行個體是否等於指定物件。 (繼承來源 Attribute) |
| MemberwiseClone() |
建立目前 Object 的淺層複製。 (繼承來源 Object) |
| ToString() |
傳回代表目前物件的字串。 (繼承來源 Object) |