IOperationBehavior Interface

Définition

Implémente des méthodes qui permettent d'étendre un comportement d'exécution pour une opération, que ce soit pour une application cliente ou de service.Implements methods that can be used to extend run-time behavior for an operation in either a service or client application.

public interface class IOperationBehavior
public interface IOperationBehavior
type IOperationBehavior = interface
Public Interface IOperationBehavior
Dérivé

Exemples

L'exemple de code suivant montre une implémentation de l'System.ServiceModel.Dispatcher.IParameterInspector qui écrit sur la console lors de l'appel à l'inspecteur sur une opération.The following code example shows an implementation of System.ServiceModel.Dispatcher.IParameterInspector that writes to the console when the inspector is invoked on an operation. Cette personnalisation ne peut être attachée à l'System.ServiceModel.Dispatcher.DispatchOperation ou l'System.ServiceModel.Dispatcher.ClientOperation et est par conséquent souvent insérée par un comportement d'opération.This customization can only be attached to the System.ServiceModel.Dispatcher.DispatchOperation or System.ServiceModel.Dispatcher.ClientOperation and is therefore usually inserted by an operation behavior.

#region IParameterInspector Members
public void AfterCall(string operationName, object[] outputs, object returnValue, object correlationState)
{
  Console.WriteLine(
    "IParameterInspector.AfterCall called for {0} with return value {1}.",
    operationName,
    returnValue.ToString()
  );
}

public object BeforeCall(string operationName, object[] inputs)
{
  Console.WriteLine("IParameterInspector.BeforeCall called for {0}.", operationName);
  return null;
}
#Region "IParameterInspector Members"
    Public Sub AfterCall(ByVal operationName As String, ByVal outputs() As Object, ByVal returnValue As Object, _
                         ByVal correlationState As Object) Implements IParameterInspector.AfterCall
        Console.WriteLine("IParameterInspector.AfterCall called for {0} with return value {1}.", _
                          operationName, returnValue.ToString())
    End Sub

    Public Function BeforeCall(ByVal operationName As String, ByVal inputs() As Object) As Object Implements _
    IParameterInspector.BeforeCall
        Console.WriteLine("IParameterInspector.BeforeCall called for {0}.", operationName)
        Return Nothing
    End Function

L'exemple de code suivant montre comment le comportement d'opération attache l'inspecteur de paramètre à l'exécution.The following code example shows how the operation behavior attaches the parameter inspector to the runtime.

#region IOperationBehavior Members
public void AddBindingParameters(
  OperationDescription operationDescription, BindingParameterCollection bindingParameters
)
{ return; }

public void ApplyClientBehavior(OperationDescription operationDescription, ClientOperation clientOperation)
{
  clientOperation.ParameterInspectors.Add(new Inspector());
}

public void ApplyDispatchBehavior(OperationDescription operationDescription, DispatchOperation dispatchOperation)
{
  dispatchOperation.ParameterInspectors.Add(new Inspector());
}

public void Validate(OperationDescription operationDescription){ return; }
#Region "IOperationBehavior Members"
    Public Sub AddBindingParameters(ByVal operationDescription As OperationDescription, _
                                    ByVal bindingParameters As BindingParameterCollection) Implements _
                                    IOperationBehavior.AddBindingParameters
        Return
    End Sub

    Public Sub ApplyClientBehavior(ByVal operationDescription As OperationDescription, ByVal _
                                   clientOperation As ClientOperation) Implements IOperationBehavior.ApplyClientBehavior
        clientOperation.ParameterInspectors.Add(New Inspector())
    End Sub

    Public Sub ApplyDispatchBehavior(ByVal operationDescription As OperationDescription, ByVal dispatchOperation As  _
                                     DispatchOperation) Implements IOperationBehavior.ApplyDispatchBehavior
        dispatchOperation.ParameterInspectors.Add(New Inspector())
    End Sub

Public Sub Validate(ByVal operationDescription As OperationDescription) Implements IOperationBehavior.Validate
    Return
End Sub

Remarques

Implémentez l'interface IOperationBehavior pour modifier, examiner ou étendre certains aspects de l'exécution à l'échelle de l'opération au niveau de l'application, que ce soit pour des applications clientes ou de service.Implement the IOperationBehavior interface to modify, examine, or extend some aspect of operation-wide execution at the application level for either client or service applications.

  • Utilisez la méthode AddBindingParameters pour passer des données personnalisées lors de l’exécution pour permettre aux liaisons de prendre en charge un comportement personnalisé.Use the AddBindingParameters method to pass custom data at runtime to enable bindings to support custom behavior.

  • Utilisez la méthode ApplyClientBehavior pour modifier, examiner ou insérer des extensions dans le répartiteur client d'une application cliente.Use the ApplyClientBehavior method to modify, examine, or insert extensions to a client dispatcher in a client application.

  • Utilisez la méthode ApplyDispatchBehavior pour modifier, examiner ou insérer des extensions dans l’exécution à l’échelle de l’opération dans une application de service.Use the ApplyDispatchBehavior method to modify, examine, or insert extensions to operation-wide execution in a service application.

  • Utilisez la méthode Validate pour confirmer qu’un OperationDescription remplit les exigences requises.Use the Validate method to confirm that a OperationDescription meets specific requirements. Elle permet d'assurer qu'une opération dispose d'un certain paramètre de configuration activé, qu'elle prend en charge une fonctionnalité particulière et d'autres spécifications.This can be used to ensure that an operation has a certain configuration setting enabled, supports a particular feature and other requirements.

IOperationBehavior les objets peuvent utiliser l’une de ces méthodes, mais souvent, un seul élément est important ; dans ce cas, les méthodes inutilisées peuvent retourner, sans effectuer d’action.IOperationBehavior objects can make use of any of these methods, but often only one is important; in such cases, the unused methods can return, performing no action.

Notes

Toutes les méthodes IOperationBehavior passent un objet OperationDescription comme paramètre.All of the IOperationBehavior methods pass an OperationDescription object as a parameter. Ce paramètre est présenté à titre d'examen uniquement ; si vous modifiez l'objet OperationDescription, le comportement d'exécution n'est pas défini.This parameter is for examination only; if you modify the OperationDescription object the execution behavior is undefined.

En général, les objets IOperationBehavior permettent d'accéder aux différentes propriétés de l'objet System.ServiceModel.Dispatcher.DispatchOperation d'une application de service et à l'objet System.ServiceModel.Dispatcher.ClientOperation d'une application cliente.IOperationBehavior objects are typically used to access the various properties of the System.ServiceModel.Dispatcher.DispatchOperation object in a service application and the System.ServiceModel.Dispatcher.ClientOperation object in a client application.

En général, le développeur examine tout d’abord les points d’extensibilité pour déterminer l’option de personnalisation qui convient au scénario d’application, puis implémente la personnalisation au niveau de la portée appropriée.Typically, the developer first reviews the extensibility points to determine which customization option suits the application scenario and then implements the customization at the appropriate scope. Par exemple, les objets System.ServiceModel.Description.IServiceBehavior peuvent insérer des personnalisations pour tous les messages dans l'intégralité d'un service et les objets System.ServiceModel.Description.IContractBehavior peuvent insérer des personnalisations pour tous les messages sur l'intégralité d'un contrat spécifique, etc.For example, System.ServiceModel.Description.IServiceBehavior objects can insert customizations for all messages in an entire service and System.ServiceModel.Description.IContractBehavior objects can insert customizations for all messages across a specific contract, and so on. Pour obtenir une description des différentes propriétés et personnalisations disponibles, consultez extension de ServiceHost et de la couche de modèle de service.For a description of the various properties and customizations available, see Extending ServiceHost and the Service Model Layer.

Une fois qu’une personnalisation a été décidée (et que l’interface de personnalisation a été implémentée si nécessaire) et que IOperationBehavior est la portée appropriée de personnalisation, la personnalisation doit être insérée dans le runtime d’Windows Communication Foundation (WCF) en implémentant IOperationBehavior et en ajoutant le comportement d’opération au Runtime.Once a customization has been decided upon (and the customization interface implemented if necessary) and the IOperationBehavior is the appropriate scope of customization, the customization must be inserted into the Windows Communication Foundation (WCF) runtime by implementing IOperationBehavior and adding the operation behavior to the runtime.

Il existe deux méthodes pour ajouter le IOperationBehavior à l'exécution :There are two ways to add the IOperationBehavior to the runtime:

  • Par programme, ajoutez le comportement d'opération personnalisé à la propriété OperationDescription.Behaviors avant l'ouverture de l'hôte de service (dans une application de service) ou de la fabrique de canal (dans une application cliente).Programmatically add the custom operation behavior to the OperationDescription.Behaviors property prior to the opening of the service host (in a service application) or the channel factory (in a client application).

  • Ajoutez le comportement à l'aide d'un attribut personnalisé.Add the behavior using a custom attribute.

Pour effectuer la tâche de personnalisation de service à laquelle il est destiné, l’objet IOperationBehavior doit être ajouté à la propriété OperationDescription.Behaviors avant la construction de l’exécution de service, qui se produit lors de l’appel à la méthode ICommunicationObject.Open sur System.ServiceModel.ServiceHost.To perform the service customization task for which it is intended, the IOperationBehavior object must be added to the OperationDescription.Behaviors property prior to the construction of the service runtime, which occurs when ICommunicationObject.Open method is called on System.ServiceModel.ServiceHost. Pour effectuer une tâche de personnalisation cliente, l’objet IOperationBehavior doit être ajouté à la propriété OperationDescription.Behaviors avant l’appel aux méthodes ChannelFactory<TChannel>.CreateChannel ou ICommunicationObject.Open sur ChannelFactory<TChannel>.To perform a client customization task, the IOperationBehavior object must be added to the OperationDescription.Behaviors property before calling the ChannelFactory<TChannel>.CreateChannel method or the ICommunicationObject.Open method on ChannelFactory<TChannel>.

Bien que le comportement d'opération soit conçu pour un accès simplifié à l'exécution au niveau de la portée d'une opération individuelle, vous pouvez accéder à l'exécution au niveau d'une plus grande portée en accédant à l'objet d'exécution parent.Although the operation behavior is designed for easy access to the runtime at the scope of an individual operation, you can access the runtime at a larger scope by accessing the parent runtime object.

Méthodes

AddBindingParameters(OperationDescription, BindingParameterCollection)

Effectuez une implémentation pour passer des données au moment de l’exécution à des liaisons afin de prendre en charge un comportement personnalisé.Implement to pass data at runtime to bindings to support custom behavior.

ApplyClientBehavior(OperationDescription, ClientOperation)

Implémente une modification ou une extension du client sur l’intégralité d’une opération.Implements a modification or extension of the client across an operation.

ApplyDispatchBehavior(OperationDescription, DispatchOperation)

Implémente une modification ou une extension du client sur l’intégralité d’une opération.Implements a modification or extension of the service across an operation.

Validate(OperationDescription)

Effectuez une implémentation pour confirmer que l'opération répond à certains critères prévus.Implement to confirm that the operation meets some intended criteria.

S’applique à