CallbackBehaviorAttribute Classe

Definizione

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

Ereditarietà

Object

Attribute

CallbackBehaviorAttribute

Attributi

AttributeUsageAttribute

Implementazioni

IEndpointBehavior

Esempio

Nell'esempio di codice seguente viene illustrato un CallbackBehaviorAttribute oggetto su un oggetto callback che utilizza l'oggetto SynchronizationContext per determinare il thread a cui eseguire il marshalling, la proprietà per applicare la ValidateMustUnderstand convalida dei messaggi e la IncludeExceptionDetailInFaults proprietà per restituire eccezioni come FaultException oggetti al servizio a scopo di debug.

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

Commenti

Usare l'attributo CallbackBehaviorAttribute per configurare o estendere il comportamento di esecuzione di un'implementazione del contratto di callback in un'applicazione client. Questo attributo esegue la stessa funzione per la classe di callback dell'attributo ServiceBehaviorAttribute , ad eccezione del comportamento di creazione di istanze e delle impostazioni delle transazioni.

Deve CallbackBehaviorAttribute essere applicato alla classe che implementa il contratto di callback. Se applicato a un'implementazione del contratto non duplex, viene generata un'eccezione InvalidOperationException in fase di esecuzione.

Sono disponibili le proprietà seguenti:

• La AutomaticSessionShutdown proprietà chiude automaticamente la sessione quando il canale viene chiuso e il callback ha terminato l'elaborazione di eventuali messaggi rimanenti.

• La ConcurrencyMode proprietà controlla il modello di threading interno, abilitando il supporto per gli oggetti callback reentrant o multithreading.

• La IgnoreExtensionDataObject proprietà consente al runtime di ignorare informazioni di serializzazione aggiuntive non necessarie per elaborare il messaggio.

• La IncludeExceptionDetailInFaults proprietà specifica se le eccezioni non gestite in un servizio vengono restituite al servizio come errori SOAP a scopo di debug.

• La MaxItemsInObjectGraph proprietà limita il numero di elementi in un oggetto grafico serializzato.

• La TransactionIsolationLevel proprietà specifica il livello di isolamento della transazione supportato dal contratto.

• La TransactionTimeout proprietà specifica il periodo di tempo entro il quale una transazione deve essere completata o interrotta.

• La UseSynchronizationContext proprietà indica se sincronizzare automaticamente le chiamate al metodo in ingresso usando l'oggetto corrente SynchronizationContext .

• La ValidateMustUnderstand proprietà informa il sistema se deve confermare che le intestazioni SOAP contrassegnate come MustUnderstand sono state effettivamente comprese.