WebGetAttribute Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Représente un attribut indiquant qu’une opération de service est logiquement une opération de récupération et qu’elle peut être appelée par le modèle de programmation REST WCF.
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
- Héritage
- Attributs
- Implémente
Exemples
L’exemple suivant montre comment utiliser l’attribut 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
Remarques
L’attribut WebGetAttribute est appliqué à une opération de service en plus de l’opération OperationContractAttribute et associe l’opération à un UriTemplate ainsi que le verbe Get du protocole HTTP. L’association avec le verbe Get HTTP signifie que l’opération est utilisée pour récupérer des informations à partir du service. L’attribut WebGetAttribute est un comportement d’opération passif (les IOperationBehavior méthodes ne font rien) qui ajoute des métadonnées à la description de l’opération. L’application de l’attribut WebGetAttribute à une opération de service n’a aucun effet, sauf si un comportement qui recherche ces métadonnées dans la description de l’opération (par exemple WebHttpBehavior) est ajouté à la collection de comportements du service.
Les opérations de service avec l’attribut WebGetAttribute appliqué doivent être des opérations de récupération logique. La méthode HTTP GET est associée à toutes les opérations marquées avec l’attribut WebGetAttribute .
Constructeurs
| Nom | Description |
|---|---|
| WebGetAttribute() |
Initialise une nouvelle instance de la classe WebGetAttribute. |
Propriétés
| Nom | Description |
|---|---|
| BodyStyle |
Obtient ou définit le style de corps des messages envoyés à et à partir de l’opération de service. |
| IsBodyStyleSetExplicitly |
Obtient la IsBodyStyleSetExplicitly propriété. |
| IsRequestFormatSetExplicitly |
Obtient la IsRequestFormatSetExplicitly propriété. |
| IsResponseFormatSetExplicitly |
Obtient la IsResponseFormatSetExplicitly propriété. |
| RequestFormat |
Obtient ou définit la RequestFormat propriété. |
| ResponseFormat |
Obtient ou définit la ResponseFormat propriété. |
| TypeId |
En cas d’implémentation dans une classe dérivée, obtient un identificateur unique pour cette Attribute. (Hérité de Attribute) |
| UriTemplate |
Obtient ou définit le modèle URI (Uniform Resource Identifier) pour l’opération de service. |
Méthodes
| Nom | Description |
|---|---|
| Equals(Object) |
Retourne une valeur qui indique si cette instance est égale à un objet spécifié. (Hérité de Attribute) |
| GetHashCode() |
Retourne le code de hachage pour cette instance. (Hérité de Attribute) |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| IsDefaultAttribute() |
En cas de substitution dans une classe dérivée, indique si la valeur de cette instance est la valeur par défaut de la classe dérivée. (Hérité de Attribute) |
| Match(Object) |
En cas de substitution dans une classe dérivée, retourne une valeur qui indique si cette instance est égale à un objet spécifié. (Hérité de Attribute) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |