WebGetAttribute クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
サービス操作が論理的には取得操作であり、WCF REST プログラミング モデルで呼び出すことができることを示す属性を表します。
public ref class WebGetAttribute sealed : Attribute, System::ServiceModel::Description::IOperationBehavior[System.AttributeUsage(System.AttributeTargets.Method)]
public sealed class WebGetAttribute : Attribute, System.ServiceModel.Description.IOperationBehavior[<System.AttributeUsage(System.AttributeTargets.Method)>]
type WebGetAttribute = class
inherit Attribute
interface IOperationBehaviorPublic NotInheritable Class WebGetAttribute
Inherits Attribute
Implements IOperationBehavior- 継承
- 属性
- 実装
例
WebGetAttribute 属性を使用する方法を次のコード例に示します。
[ServiceContract]
public interface ICalculator
{
[OperationContract]
[WebGet]
long Add(long x, long y);
[OperationContract]
[WebGet(UriTemplate = "Sub?x={x}&y={y}")]
long Subtract(long x, long y);
[OperationContract]
[WebGet(UriTemplate = "Mult?x={x}&y={y}", BodyStyle = WebMessageBodyStyle.Bare)]
long Multiply(long x, long y);
[OperationContract]
[WebGet(UriTemplate = "Div?x={x}&y={y}", RequestFormat = WebMessageFormat.Xml)]
long Divide(long x, long y);
[OperationContract]
[WebGet(ResponseFormat= WebMessageFormat.Json)]
long Mod(long x, long y);
}
<ServiceContract()> _
Public Interface ICalculator
<OperationContract()> _
<WebGet()> _
Function Add(ByVal x As Long, ByVal y As Long) As Long
<OperationContract()> _
<WebGet(UriTemplate:="Sub?x={x}&y={y}")> _
Function Subtract(ByVal x As Long, ByVal y As Long) As Long
<OperationContract()> _
<WebGet(UriTemplate:="Mult?x={x}&y={y}", BodyStyle:=WebMessageBodyStyle.Bare)> _
Function Multiply(ByVal x As Long, ByVal y As Long) As Long
<OperationContract()> _
<WebGet(UriTemplate:="Div?x={x}&y={y}", RequestFormat:=WebMessageFormat.Xml)> _
Function Divide(ByVal x As Long, ByVal y As Long) As Long
<OperationContract()> _
<WebGet(ResponseFormat:=WebMessageFormat.Json)> _
Function Modulo(ByVal x As Long, ByVal y As Long) As Long
End Interface
注釈
WebGetAttribute 属性は、OperationContractAttribute に加えてサービス操作に適用され、その操作を、HTTP プロトコルの Get 動詞と同様に UriTemplate と関連付けます。 HTTP の Get 動詞と関連付けるということは、その操作がサービスから情報を取得するために使用されることを意味します。 この WebGetAttribute 属性は、 操作 の説明にメタデータを IOperationBehavior 追加するパッシブ操作動作 (メソッドは何も行いません) です。 このメタデータを操作の説明で検索する動作 (WebGetAttribute など) がサービスの動作コレクションに追加されていない場合は、WebHttpBehavior 属性をサービス操作に適用しても機能しません。
WebGetAttribute 属性を適用されたサービス操作は、論理的な取得操作です。 HTTP GET メソッドは WebGetAttribute 属性付きのすべての操作に関連付けられます。
コンストラクター
| WebGetAttribute() |
WebGetAttribute クラスの新しいインスタンスを初期化します。 |
プロパティ
| BodyStyle |
サービス操作との間で送受信されるメッセージの本文のスタイルを取得または設定します。 |
| IsBodyStyleSetExplicitly |
IsBodyStyleSetExplicitly プロパティを取得します。 |
| IsRequestFormatSetExplicitly |
IsRequestFormatSetExplicitly プロパティを取得します。 |
| IsResponseFormatSetExplicitly |
IsResponseFormatSetExplicitly プロパティを取得します。 |
| RequestFormat |
RequestFormat プロパティを取得または設定します。 |
| ResponseFormat |
ResponseFormat プロパティを取得または設定します。 |
| TypeId |
派生クラスで実装されると、この Attribute の一意の識別子を取得します。 (継承元 Attribute) |
| UriTemplate |
サービス操作の URI (Uniform Resource Identifier) テンプレートを取得または設定します。 |
メソッド
| Equals(Object) |
このインスタンスが、指定されたオブジェクトと等価であるかどうかを示す値を返します。 (継承元 Attribute) |
| GetHashCode() |
このインスタンスのハッシュ コードを返します。 (継承元 Attribute) |
| GetType() |
現在のインスタンスの Type を取得します。 (継承元 Object) |
| IsDefaultAttribute() |
派生クラスでオーバーライドされるとき、このインスタンスの値が派生クラスの既定値であるかどうかを示します。 (継承元 Attribute) |
| Match(Object) |
派生クラス内でオーバーライドされたときに、指定したオブジェクトとこのインスタンスが等しいかどうかを示す値を返します。 (継承元 Attribute) |
| MemberwiseClone() |
現在の Object の簡易コピーを作成します。 (継承元 Object) |
| ToString() |
現在のオブジェクトを表す文字列を返します。 (継承元 Object) |