Freigeben über


WebGetAttribute Klasse

Definition

Stellt ein Attribut dar, dass angibt dass ein Dienstvorgang logisch als Abrufvorgang gilt und mit dem 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
WebGetAttribute
Attribute
Implementiert

Beispiele

Im folgenden Beispiel wird die Verwendung des WebGetAttribute-Attributs veranschaulicht.

[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 OperationContractAttribute auf einen Dienstvorgang angewendet und ordnet den Vorgang einer UriTemplate sowie dem GET-Verb des HTTP-Protokolls zu. Die Zuordnung zu dem HTTP-GET-Verb bedeutet, dass der Vorgang zum Abrufen von Informationen vom Dienst verwendet wird. Das WebGetAttribute Attribut ist ein passives Vorgangsverhalten (die IOperationBehavior Methoden tun nichts), das Metadaten zur Vorgangsbeschreibung hinzufügt. Die Anwendung des WebGetAttribute-Attributs auf einen Dienstvorgang hat nur dann Auswirkungen, wenn ein Verhalten, das in der Vorgangsbeschreibung nach diesen Metadaten sucht (beispielsweise WebHttpBehavior), der Verhaltensauflistung des Diensts hinzugefügt wird.

Dienstvorgänge mit dem WebGetAttribute-Attribut müssen logische Abrufvorgänge sein. Die HTTP-GET-Methode wird allen mit dem WebGetAttribute-Attribut gekennzeichneten Vorgängen zugeordnet.

Konstruktoren

WebGetAttribute()

Initialisiert eine neue Instanz der WebGetAttribute-Klasse.

Eigenschaften

BodyStyle

Ruft das Textformat der Nachrichten ab, die an den Dienstvorgang bzw. von dem Dienstvorgang gesendet werden, oder legt dieses fest.

IsBodyStyleSetExplicitly

Ruft die IsBodyStyleSetExplicitly-Eigenschaft ab.

IsRequestFormatSetExplicitly

Ruft die IsRequestFormatSetExplicitly-Eigenschaft ab.

IsResponseFormatSetExplicitly

Ruft die IsResponseFormatSetExplicitly-Eigenschaft ab.

RequestFormat

Ruft die RequestFormat-Eigenschaft ab oder legt diese fest.

ResponseFormat

Ruft die ResponseFormat-Eigenschaft ab oder legt diese fest.

TypeId

Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab.

(Geerbt von Attribute)
UriTemplate

Ruft die URI-Vorlage (Uniform Resource Identifier) für den Dienstvorgang ab oder legt diese fest.

Methoden

Equals(Object)

Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist.

(Geerbt von Attribute)
GetHashCode()

Gibt den Hashcode für diese Instanz zurück.

(Geerbt von Attribute)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
IsDefaultAttribute()

Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist.

(Geerbt von Attribute)
Match(Object)

Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht.

(Geerbt von Attribute)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Explizite Schnittstellenimplementierungen

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu.

(Geerbt von Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Ruft die Typinformationen für ein Objekt ab, mit deren Hilfe die Typinformationen für eine Schnittstelle abgerufen werden können.

(Geerbt von Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1).

(Geerbt von Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Stellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit.

(Geerbt von Attribute)
IOperationBehavior.AddBindingParameters(OperationDescription, BindingParameterCollection)

Implementiert die AddBindingParameters(OperationDescription, BindingParameterCollection)-Methode.

IOperationBehavior.ApplyClientBehavior(OperationDescription, ClientOperation)

Implementiert die ApplyClientBehavior(OperationDescription, ClientOperation)-Methode.

IOperationBehavior.ApplyDispatchBehavior(OperationDescription, DispatchOperation)

Implementiert die ApplyDispatchBehavior(OperationDescription, DispatchOperation)-Methode.

IOperationBehavior.Validate(OperationDescription)

Implementiert die Validate(OperationDescription)-Methode.

Gilt für