ServiceContractAttribute.CallbackContract Proprietà

Definizione

Spazio dei nomi:

System.ServiceModel

Assembly:

System.ServiceModel.Primitives.dll

Assembly:

System.ServiceModel.dll

Ottiene o imposta il tipo di contratto di callback quando il contratto è duplex.

public:
 property Type ^ CallbackContract { Type ^ get(); void set(Type ^ value); };

public Type CallbackContract { get; set; }

member this.CallbackContract : Type with get, set

Public Property CallbackContract As Type

Valore della proprietà

Type

Oggetto Type che indica il contratto di callback. Il valore predefinito è null.

Esempio

Nell'esempio di codice seguente viene illustrato un servizio che specifica un contratto di callback, che indica che un servizio di tipo deve avere un corrispondente che implementa un servizio di tipo IDuplexHello IHelloCallbackContract. Implementa inoltre IHelloCallbackContract un metodo di callback unidirezionale, consentendo al servizio di chiamare il client senza attendere che una risposta supporti un client distribuito e basato su eventi.

using System;
using System.Collections.Generic;
using System.ServiceModel;
using System.Threading;

namespace Microsoft.WCF.Documentation
{
  [ServiceContract(
    Name = "SampleDuplexHello",
    Namespace = "http://microsoft.wcf.documentation",
    CallbackContract = typeof(IHelloCallbackContract),
    SessionMode = SessionMode.Required
  )]
  public interface IDuplexHello
  {
    [OperationContract(IsOneWay = true)]
    void Hello(string greeting);
  }

  public interface IHelloCallbackContract
  {
    [OperationContract(IsOneWay = true)]
    void Reply(string responseToGreeting);
  }

  public class DuplexHello : IDuplexHello
  {
    public DuplexHello()
    {
      Console.WriteLine("Service object created: " + this.GetHashCode().ToString());
    }

    ~DuplexHello()
    {
      Console.WriteLine("Service object destroyed: " + this.GetHashCode().ToString());
    }

    public void Hello(string greeting)
    {
      Console.WriteLine("Caller sent: " + greeting);
      Console.WriteLine("Session ID: " + OperationContext.Current.SessionId);
      Console.WriteLine("Waiting two seconds before returning call.");
      // Put a slight delay to demonstrate asynchronous behavior on client.
      Thread.Sleep(2000);
      IHelloCallbackContract callerProxy
        = OperationContext.Current.GetCallbackChannel<IHelloCallbackContract>();
      string response = "Service object " + this.GetHashCode().ToString() + " received: " + greeting;
      Console.WriteLine("Sending back: " + response);
      callerProxy.Reply(response);
    }
  }
}

Imports System.Collections.Generic
Imports System.ServiceModel
Imports System.Threading

Namespace Microsoft.WCF.Documentation
    <ServiceContract(Name:="SampleDuplexHello", Namespace:="http://microsoft.wcf.documentation", _
                     CallbackContract:=GetType(IHelloCallbackContract), SessionMode:=SessionMode.Required)> _
  Public Interface IDuplexHello
        <OperationContract(IsOneWay:=True)> _
        Sub Hello(ByVal greeting As String)
    End Interface

  Public Interface IHelloCallbackContract
    <OperationContract(IsOneWay := True)> _
    Sub Reply(ByVal responseToGreeting As String)
  End Interface

  Public Class DuplexHello
      Implements IDuplexHello
    Public Sub New()
      Console.WriteLine("Service object created: " & Me.GetHashCode().ToString())
    End Sub

    Protected Overrides Sub Finalize()
      Console.WriteLine("Service object destroyed: " & Me.GetHashCode().ToString())
    End Sub

    Public Sub Hello(ByVal greeting As String) Implements IDuplexHello.Hello
      Console.WriteLine("Caller sent: " & greeting)
      Console.WriteLine("Session ID: " & OperationContext.Current.SessionId)
      Console.WriteLine("Waiting two seconds before returning call.")
      ' Put a slight delay to demonstrate asynchronous behavior on client.
      Thread.Sleep(2000)
            Dim callerProxy = OperationContext.Current.GetCallbackChannel(Of IHelloCallbackContract)()
            Dim response = "Service object " & Me.GetHashCode().ToString() & " received: " & greeting
      Console.WriteLine("Sending back: " & response)
      callerProxy.Reply(response)
    End Sub
  End Class
End Namespace

Commenti

Specificare un'interfaccia CallbackContract nella proprietà che rappresenta il contratto opposto richiesto in uno scambio di messaggi bidirezionali (o duplex). Ciò consente alle applicazioni client di restare in ascolto delle chiamate di operazioni in ingresso che l'applicazione di servizio lato server può inviare indipendentemente dall'attività dei client. I contratti di callback contenenti operazioni unidirezionali rappresentano le chiamate provenienti dal servizio che il client è in grado di gestire.

Nota

L'attributo ServiceContractAttribute viene ignorato nei contratti di callback. Per configurare il comportamento di runtime degli oggetti callback, usare .System.ServiceModel.CallbackBehaviorAttribute