OperationContractAttribute Classe

Définition

public ref class OperationContractAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Method)]
public sealed class OperationContractAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Method)>]
type OperationContractAttribute = class
    inherit Attribute

Public NotInheritable Class OperationContractAttribute
Inherits Attribute

Héritage

Object

Attribute

OperationContractAttribute

Attributs

AttributeUsageAttribute

Exemples

L'exemple de code suivant présente un contrat de service simple avec une opération.

using System;
using System.Collections.Generic;
using System.Net.Security;
using System.ServiceModel;
using System.Text;

namespace Microsoft.WCF.Documentation
{
  [ServiceContract(Namespace="Microsoft.WCF.Documentation")]
  public interface ISampleService{
    // This operation specifies an explicit protection level requirement.
    [OperationContract(ProtectionLevel=ProtectionLevel.EncryptAndSign)]
    string SampleMethod(string msg);
  }

  class SampleService : ISampleService
  {
  #region ISampleService Members

  public string  SampleMethod(string msg)
  {
    Console.WriteLine("Called with: {0}", msg);
      return "The service greets you: " + msg;
  }

  #endregion
  }
}

Imports System.Net.Security
Imports System.ServiceModel
Imports System.Text

Namespace Microsoft.WCF.Documentation
  <ServiceContract(Namespace:="Microsoft.WCF.Documentation")> _
  Public Interface ISampleService
    ' This operation specifies an explicit protection level requirement.
    <OperationContract(ProtectionLevel:=ProtectionLevel.EncryptAndSign)> _
    Function SampleMethod(ByVal msg As String) As String
  End Interface

  Friend Class SampleService
      Implements ISampleService
  #Region "ISampleService Members"

  Public Function SampleMethod(ByVal msg As String) As String Implements ISampleService.SampleMethod
    Console.WriteLine("Called with: {0}", msg)
       Return "The service greets you: " & msg
  End Function

  #End Region
  End Class
End Namespace

L'exemple suivant est un service qui implémente un contrat de service implicite qui spécifie trois opérations. Deux des opérations sont des opérations bidirectionnelles, qui retournent des messages de réponse sous-jacents à l'appelant, quelle que soit la valeur de retour. La troisième opération reçoit un appel, un message entrant sous-jacent, mais ne retourne aucun message de réponse sous-jacent.

[ServiceContractAttribute]  
public class OneAndTwoWay  
{  
  // The client waits until a response message appears.  
  [OperationContractAttribute]  
  public int MethodOne (int x, out int y)  
  {  
    y = 34;  
    return 0;  
  }  

  // The client waits until an empty response message appears.  
  [OperationContractAttribute]  
  public void MethodTwo (int x)  
  {  
    return;  
  }  

  // The client returns as soon as an outbound message  
  // is dispatched to the service; no response  
  // message is generated or sent from the service.  
  [OperationContractAttribute(IsOneWay=true)]  
  public void MethodThree (int x)  
  {  
    return;  
  }  
}  

Remarques

Appliquez l'OperationContractAttribute à une méthode pour indiquer que la méthode implémente une opération de service dans le cadre d'un contrat de service (spécifié par un attribut ServiceContractAttribute ).

Utilisez les propriétés OperationContractAttribute pour contrôler la structure de l'opération et les valeurs exprimées dans les métadonnées :

• La propriété Action spécifie l'action qui identifie cette opération de façon unique. WCF distribue les messages de demande aux méthodes en fonction de leur action.

• La propriété AsyncPattern indique que l'opération est implémentée ou peut être appelée de façon asynchrone à l'aide d'une paire de méthodes Begin/End.

• La propriété HasProtectionLevel indique si la propriété ProtectionLevel a été explicitement définie.

• La propriété IsOneWay indique que l'opération se compose uniquement d'un message d'entrée. Aucun message de sortie n'est associé à l'opération.

• La propriété IsInitiating spécifie si cette opération peut être l'opération initiale dans une session.

• La IsTerminating propriété spécifie si WCF tente d’arrêter la session active une fois l’opération terminée.

• La propriété ProtectionLevel spécifie la sécurité au niveau du message qu'une opération requiert au moment de l'exécution.

• La propriété ReplyAction spécifie l'action du message de réponse pour l'opération.

L'attribut OperationContractAttribute déclare qu'une méthode est une opération dans un contrat de service. Seules les méthodes qui possèdent l'attribut OperationContractAttribute sont exposées comme opérations de service. Un contrat de service sans méthode marquée avec l'OperationContractAttribute n'expose aucune opération.

La AsyncPattern propriété indique qu’une paire de<Begin méthodes methodName> et End<methodName> forme une seule opération implémentée de manière asynchrone (que ce soit sur le client ou le service). La capacité d'un service à implémenter des opérations de façon asynchrone est un détail d'implémentation du service et n'est pas exposée dans les métadonnées (comme WSDL (Web Services Description Language)).

De même, les clients peuvent choisir d'appeler des opérations de façon asynchrone indépendantes de la façon dont la méthode de service est implémentée. Appeler des opérations de service de façon asynchrone dans le client est recommandé lorsqu'une méthode de service prend du temps mais qu'elle doit retourner directement des informations au client. Pour plus d'informations, consultez AsyncPattern.

La propriété IsOneWay indique qu'une méthode ne retourne pas de valeur du tout, y compris un message de réponse sous-jacent vide. Ce type de méthode est utile pour les notifications ou la communication de style événement. Les méthodes de ce type ne peuvent pas retourner de message de réponse. La déclaration de la méthode doit donc retourner void.

Les propriétés Action et ReplyAction peuvent être utilisées non seulement pour modifier l'action par défaut des messages SOAP, mais également pour créer des gestionnaires pour les messages non reconnus ou désactiver les actions d'ajout pour la programmation de message directe. Utilisez la propriété IsInitiating pour éviter que les clients appellent une opération de service particulière avant d'autres opérations. Utilisez la IsTerminating propriété pour que WCF ferme le canal après que les clients ont appelé une opération de service particulière. Pour plus d’informations, consultez Utilisation de sessions.

La propriété ProtectionLevel vous permet de spécifier sur le contrat d'opération si les messages d'opération sont signés, chiffrés ou signés et chiffrés. Si une liaison ne peut pas fournir le niveau de sécurité requis par le contrat, une exception est levée au moment de l’exécution. Pour plus d’informations, consultez ProtectionLevelComprendre le niveau de protection.

Constructeurs

Propriétés

Méthodes

Implémentations d’interfaces explicites

S’applique à