CallbackBehaviorAttribute Classe

Définition

public ref class CallbackBehaviorAttribute sealed : Attribute, System::ServiceModel::Description::IEndpointBehavior

[System.AttributeUsage(System.AttributeTargets.Class)]
public sealed class CallbackBehaviorAttribute : Attribute, System.ServiceModel.Description.IEndpointBehavior

[<System.AttributeUsage(System.AttributeTargets.Class)>]
type CallbackBehaviorAttribute = class
    inherit Attribute
    interface IEndpointBehavior

Public NotInheritable Class CallbackBehaviorAttribute
Inherits Attribute
Implements IEndpointBehavior

Héritage

Object

Attribute

CallbackBehaviorAttribute

Attributs

AttributeUsageAttribute

Implémente

IEndpointBehavior

Exemples

L’exemple de code suivant montre un CallbackBehaviorAttribute objet de rappel qui utilise l’objet pour déterminer le SynchronizationContext thread à marshaler, la propriété pour appliquer la ValidateMustUnderstand validation des messages et la IncludeExceptionDetailInFaults propriété pour renvoyer des exceptions en tant qu’objets FaultException au service à des fins de débogage.

using System;
using System.ServiceModel;
using System.ServiceModel.Channels;
using System.Threading;

namespace Microsoft.WCF.Documentation
{
  [CallbackBehaviorAttribute(
   IncludeExceptionDetailInFaults= true,
    UseSynchronizationContext=true,
    ValidateMustUnderstand=true
  )]
  public class Client : SampleDuplexHelloCallback
  {
    AutoResetEvent waitHandle;

    public Client()
    {
      waitHandle = new AutoResetEvent(false);
    }

    public void Run()
    {
      // Picks up configuration from the configuration file.
      SampleDuplexHelloClient wcfClient
        = new SampleDuplexHelloClient(new InstanceContext(this), "WSDualHttpBinding_SampleDuplexHello");
      try
      {
        Console.ForegroundColor = ConsoleColor.White;
        Console.WriteLine("Enter a greeting to send and press ENTER: ");
        Console.Write(">>> ");
        Console.ForegroundColor = ConsoleColor.Green;
        string greeting = Console.ReadLine();
        Console.ForegroundColor = ConsoleColor.White;
        Console.WriteLine("Called service with: \r\n\t" + greeting);
        wcfClient.Hello(greeting);
        Console.WriteLine("Execution passes service call and moves to the WaitHandle.");
        this.waitHandle.WaitOne();
        Console.ForegroundColor = ConsoleColor.Blue;
        Console.WriteLine("Set was called.");
        Console.Write("Press ");
        Console.ForegroundColor = ConsoleColor.Red;
        Console.Write("ENTER");
        Console.ForegroundColor = ConsoleColor.Blue;
        Console.Write(" to exit...");
        Console.ReadLine();
      }
      catch (TimeoutException timeProblem)
      {
        Console.WriteLine("The service operation timed out. " + timeProblem.Message);
        Console.ReadLine();
      }
      catch (CommunicationException commProblem)
      {
        Console.WriteLine("There was a communication problem. " + commProblem.Message);
        Console.ReadLine();
      }
    }
    public static void Main()
    {
      Client client = new Client();
      client.Run();
    }

    public void Reply(string response)
    {
      Console.WriteLine("Received output.");
      Console.WriteLine("\r\n\t" + response);
      this.waitHandle.Set();
    }
  }
}

Imports System.ServiceModel
Imports System.ServiceModel.Channels
Imports System.Threading

Namespace Microsoft.WCF.Documentation
  <CallbackBehaviorAttribute(IncludeExceptionDetailInFaults:= True, UseSynchronizationContext:=True, ValidateMustUnderstand:=True)> _
  Public Class Client
      Implements SampleDuplexHelloCallback
    Private waitHandle As AutoResetEvent

    Public Sub New()
      waitHandle = New AutoResetEvent(False)
    End Sub

    Public Sub Run()
      ' Picks up configuration from the configuration file.
      Dim wcfClient As New SampleDuplexHelloClient(New InstanceContext(Me), "WSDualHttpBinding_SampleDuplexHello")
      Try
        Console.ForegroundColor = ConsoleColor.White
        Console.WriteLine("Enter a greeting to send and press ENTER: ")
        Console.Write(">>> ")
        Console.ForegroundColor = ConsoleColor.Green
        Dim greeting As String = Console.ReadLine()
        Console.ForegroundColor = ConsoleColor.White
        Console.WriteLine("Called service with: " & Constants.vbCrLf & Constants.vbTab & greeting)
        wcfClient.Hello(greeting)
        Console.WriteLine("Execution passes service call and moves to the WaitHandle.")
        Me.waitHandle.WaitOne()
        Console.ForegroundColor = ConsoleColor.Blue
        Console.WriteLine("Set was called.")
        Console.Write("Press ")
        Console.ForegroundColor = ConsoleColor.Red
        Console.Write("ENTER")
        Console.ForegroundColor = ConsoleColor.Blue
        Console.Write(" to exit...")
        Console.ReadLine()
      Catch timeProblem As TimeoutException
        Console.WriteLine("The service operation timed out. " & timeProblem.Message)
        Console.ReadLine()
      Catch commProblem As CommunicationException
        Console.WriteLine("There was a communication problem. " & commProblem.Message)
        Console.ReadLine()
      End Try
    End Sub
    Public Shared Sub Main()
      Dim client As New Client()
      client.Run()
    End Sub

    Public Sub Reply(ByVal response As String) Implements SampleDuplexHelloCallback.Reply
      Console.WriteLine("Received output.")
      Console.WriteLine(Constants.vbCrLf & Constants.vbTab & response)
      Me.waitHandle.Set()
    End Sub
  End Class
End Namespace

Remarques

Utilisez l’attribut CallbackBehaviorAttribute pour configurer ou étendre le comportement d’exécution d’une implémentation de contrat de rappel dans une application cliente. Cet attribut effectue la même fonction pour la classe de rappel que l’attribut ServiceBehaviorAttribute à l’exception du comportement d’instanciation et des paramètres de transaction.

Doit CallbackBehaviorAttribute être appliqué à la classe qui implémente le contrat de rappel. Si elle est appliquée à une implémentation de contrat non duplex, une InvalidOperationException exception est levée au moment de l’exécution.

Les propriétés suivantes sont disponibles :

• La AutomaticSessionShutdown propriété ferme automatiquement la session lorsque le canal est fermé et que le rappel a terminé le traitement des messages restants.

• La ConcurrencyMode propriété contrôle le modèle de thread interne, ce qui permet la prise en charge des objets de rappel reentrant ou multithread.

• La IgnoreExtensionDataObject propriété permet au runtime d’ignorer les informations de sérialisation supplémentaires qui ne sont pas requises pour traiter le message.

• La IncludeExceptionDetailInFaults propriété spécifie si les exceptions non gérées dans un service sont retournées au service en tant qu’erreurs SOAP à des fins de débogage.

• La MaxItemsInObjectGraph propriété limite le nombre d’éléments d’un graphique d’objet sérialisé.

• La TransactionIsolationLevel propriété spécifie le niveau d’isolation des transactions pris en charge par le contrat.

• La TransactionTimeout propriété spécifie la période pendant laquelle une transaction doit se terminer ou abandonner.

• La UseSynchronizationContext propriété indique s’il faut synchroniser automatiquement les appels de méthode entrante à l’aide de l’objet actuel SynchronizationContext .

• La ValidateMustUnderstand propriété informe le système s’il doit confirmer que les en-têtes SOAP marqués comme MustUnderstand étant, en fait, ont été compris.