WebGetAttribute Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt ein Attribut dar, das angibt, dass ein Dienstvorgang logisch ein Abrufvorgang ist und dass er vom WCF REST-Programmiermodell aufgerufen werden kann.
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 IOperationBehavior
Public NotInheritable Class WebGetAttribute
Inherits Attribute
Implements IOperationBehavior
- Vererbung
- Attribute
- Implementiert
Beispiele
Das folgende Beispiel zeigt, wie das WebGetAttribute Attribut verwendet wird.
[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
Hinweise
Das WebGetAttribute Attribut wird zusätzlich zu den OperationContractAttribute Vorgängen des Diensts sowie dem HTTP-Protokoll-Get-Verb auf einen Dienstvorgang angewendet und dem UriTemplate Vorgang zugeordnet. Die Zuordnung mit dem HTTP Get-Verb bedeutet, dass der Vorgang verwendet wird, um Informationen aus dem Dienst abzurufen. Das Attribut ist ein WebGetAttribute Vorgangsverhalten (die IOperationBehavior Methoden tun nichts), das der Vorgangsbeschreibung Metadaten hinzufügt. Das Anwenden des WebGetAttribute Attributs auf einen Dienstvorgang hat keine Auswirkung, es sei denn, ein Verhalten, das in der Vorgangsbeschreibung nach diesen Metadaten sucht (z WebHttpBehavior. B. ) wird der Verhaltensauflistung des Diensts hinzugefügt.
Dienstvorgänge mit dem angewendeten WebGetAttribute Attribut sollten logische Abrufvorgänge sein. Die HTTP GET-Methode ist allen Vorgängen zugeordnet, die mit dem WebGetAttribute Attribut gekennzeichnet sind.
Konstruktoren
| Name | Beschreibung |
|---|---|
| WebGetAttribute() |
Initialisiert eine neue Instanz der WebGetAttribute-Klasse. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| BodyStyle |
Dient zum Abrufen oder Festlegen des Textkörperstils der Nachrichten, die an und vom Dienstvorgang gesendet werden. |
| IsBodyStyleSetExplicitly |
Ruft die IsBodyStyleSetExplicitly Eigenschaft ab. |
| IsRequestFormatSetExplicitly |
Ruft die IsRequestFormatSetExplicitly Eigenschaft ab. |
| IsResponseFormatSetExplicitly |
Ruft die IsResponseFormatSetExplicitly Eigenschaft ab. |
| RequestFormat |
Dient zum Abrufen oder Festlegen der RequestFormat Eigenschaft. |
| ResponseFormat |
Dient zum Abrufen oder Festlegen der ResponseFormat Eigenschaft. |
| TypeId |
Wenn sie in einer abgeleiteten Klasse implementiert wird, wird ein eindeutiger Bezeichner für diese Attribute. (Geerbt von Attribute) |
| UriTemplate |
Dient zum Abrufen oder Festlegen der URI-Vorlage (Uniform Resource Identifier) für den Dienstvorgang. |
Methoden
| Name | Beschreibung |
|---|---|
| Equals(Object) |
Gibt einen Wert zurück, der angibt, ob diese Instanz einem angegebenen Objekt entspricht. (Geerbt von Attribute) |
| GetHashCode() |
Gibt den Hashcode für diesen instance zurück. (Geerbt von Attribute) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| IsDefaultAttribute() |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, gibt an, ob der Wert dieser Instanz der Standardwert für die abgeleitete Klasse ist. (Geerbt von Attribute) |
| Match(Object) |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem angegebenen Objekt entspricht. (Geerbt von Attribute) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |