DuplexClientBase<TChannel> Classe

Référence

Définition

Espace de noms:: System.ServiceModel

Assembly:: System.ServiceModel.Duplex.dll

Assembly:: System.ServiceModel.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Utilisé pour créer un canal à un service en duplex et associer ce canal à un objet de rappel.

generic <typename TChannel>
 where TChannel : classpublic ref class DuplexClientBase abstract : System::ServiceModel::ClientBase<TChannel>

generic <typename TChannel>
 where TChannel : classpublic ref class DuplexClientBase : System::ServiceModel::ClientBase<TChannel>

public abstract class DuplexClientBase<TChannel> : System.ServiceModel.ClientBase<TChannel> where TChannel : class

public class DuplexClientBase<TChannel> : System.ServiceModel.ClientBase<TChannel> where TChannel : class

type DuplexClientBase<'Channel (requires 'Channel : null)> = class
    inherit ClientBase<'Channel (requires 'Channel : null)>

Public MustInherit Class DuplexClientBase(Of TChannel)
Inherits ClientBase(Of TChannel)

Public Class DuplexClientBase(Of TChannel)
Inherits ClientBase(Of TChannel)

Paramètres de type

TChannel

Type du canal à créer.

Héritage: Object

ClientBase<TChannel>
DuplexClientBase<TChannel>

Exemples

L’exemple suivant montre l’utilisation dans le client d’un type de client WCF duplex, le SampleDuplexHelloClient, pour transmettre un nouvel System.ServiceModel.InstanceContext objet avec l’objet de rappel pour écouter les rappels.

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 la classe DuplexClientBase<TChannel> pour créer un canal à un service qui spécifie un objet de rappel. L’objet DuplexClientBase<TChannel> encapsule un System.ServiceModel.DuplexChannelFactory<TChannel> objet, qui fournit la connectivité de l’objet WCF. Vous pouvez utiliser l'un des deux types pour établir la connexion avec un service en duplex. Pour plus d’informations sur les services duplex, consultez Services duplex.

Remarque spéciale destinée aux utilisateurs C++ managés dérivés de cette classe :

Placez votre code de nettoyage dans (On)(Begin)Close (et/ou OnAbort), pas dans un destructeur.
Évitez les destructeurs : ils provoquent la génération automatique de IDisposable par le destructeur.
Évitez les membres sans référence : ils peuvent provoquer la génération automatique de IDisposable par le compilateur.
Évitez les finaliseurs ; toutefois, si vous en incluez un, vous devez supprimer l'avertissement de génération et appeler SuppressFinalize(Object) et le finaliseur lui-même à partir de (On)(Begin)Close (et/ou OnAbort) pour émuler ce qui aurait été le comportement IDisposable généré automatiquement.

Constructeurs

DuplexClientBase<TChannel>(InstanceContext)	Initialise une nouvelle instance de la classe DuplexClientBase<TChannel> à l'aide de l'objet de rappel spécifié.
DuplexClientBase<TChannel>(InstanceContext, Binding, EndpointAddress)	Initialise une nouvelle instance de la classe DuplexClientBase<TChannel> à l’aide de l’objet de rappel, de la liaison et de l’adresse de point de terminaison de service spécifiés.
DuplexClientBase<TChannel>(InstanceContext, ServiceEndpoint)	Initialise une nouvelle instance de la classe DuplexClientBase<TChannel> avec l'objet de rappel et le point de terminaison de service spécifiés.
DuplexClientBase<TChannel>(InstanceContext, String)	Initialise une nouvelle instance de la classe DuplexClientBase<TChannel> avec l'objet de rappel et le nom de configuration spécifiés.
DuplexClientBase<TChannel>(InstanceContext, String, EndpointAddress)	Initialise une nouvelle instance de la classe DuplexClientBase<TChannel> à l'aide de l'objet de rappel, du nom de configuration et de l'adresse de point de terminaison de service spécifiés.
DuplexClientBase<TChannel>(InstanceContext, String, String)	Initialise une nouvelle instance de la classe DuplexClientBase<TChannel> à l'aide de l'objet de rappel, du nom de configuration et de l'adresse de point de terminaison de service spécifiés.
DuplexClientBase<TChannel>(Object)	Initialise une nouvelle instance de la classe DuplexClientBase<TChannel> à l'aide de l'objet de rappel spécifié.
DuplexClientBase<TChannel>(Object, Binding, EndpointAddress)	Initialise une nouvelle instance de la classe DuplexClientBase<TChannel> à l’aide de l’objet de rappel, de la liaison et de l’adresse de point de terminaison de service spécifiés.
DuplexClientBase<TChannel>(Object, ServiceEndpoint)	Initialise une nouvelle instance de la classe DuplexClientBase<TChannel> avec l'objet de rappel et le point de terminaison de service spécifiés.
DuplexClientBase<TChannel>(Object, String)	Initialise une nouvelle instance de la classe DuplexClientBase<TChannel> avec l'objet de rappel et le nom de configuration spécifiés.
DuplexClientBase<TChannel>(Object, String, EndpointAddress)	Initialise une nouvelle instance de la classe DuplexClientBase<TChannel> à l'aide de l'objet de rappel, du nom de configuration et de l'adresse de point de terminaison de service spécifiés.
DuplexClientBase<TChannel>(Object, String, String)	Initialise une nouvelle instance de la classe DuplexClientBase<TChannel> à l'aide de l'objet de rappel, du nom de configuration de point de terminaison et de l'adresse de point de terminaison de service spécifiés.

Propriétés

Channel	Obtient le canal interne utilisé pour envoyer des messages à divers points de terminaison de service configurés. (Hérité de ClientBase<TChannel>)
ChannelFactory	Obtient l'objet ChannelFactory<TChannel> sous-jacent. (Hérité de ClientBase<TChannel>)
ClientCredentials	Obtient les informations d'identification du client utilisées pour appeler une opération. (Hérité de ClientBase<TChannel>)
Endpoint	Obtient le point de terminaison cible pour le service auquel le client WCF peut se connecter. (Hérité de ClientBase<TChannel>)
InnerChannel	Obtient l'implémentation IClientChannel sous-jacente. (Hérité de ClientBase<TChannel>)
InnerDuplexChannel	Obtient l’implémentation IClientChannel sous-jacente pour le canal en duplex.
State	Obtient l'état actuel de l'objet ClientBase<TChannel>. (Hérité de ClientBase<TChannel>)

Méthodes

Abort()	Provoque la transition immédiate d'un objet ClientBase<TChannel> de son état actuel à l'état fermé. (Hérité de ClientBase<TChannel>)
Close()	Provoque la transition d'un objet ClientBase<TChannel> de son état actuel à l'état fermé. (Hérité de ClientBase<TChannel>)
CreateChannel()	Retourne un canal au service associé à l'objet de rappel passé au constructeur.
CreateChannel()	Retourne un nouveau canal conduisant au service. (Hérité de ClientBase<TChannel>)
DisplayInitializationUI()	Demande au canal interne d'afficher une interface utilisateur lorsque celle-ci est requise pour initialiser le canal avant son utilisation. (Hérité de ClientBase<TChannel>)
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetDefaultValueForInitialization<T>()	Réplique le comportement du mot clé par défaut en C#. (Hérité de ClientBase<TChannel>)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
InvokeAsync(ClientBase<TChannel>.BeginOperationDelegate, Object[], ClientBase<TChannel>.EndOperationDelegate, SendOrPostCallback, Object)	Prend en charge l'implémentation du modèle asynchrone basé sur des événements. Pour plus d’informations sur ce modèle, consultez Vue d’ensemble du modèle asynchrone basé sur les événements. (Hérité de ClientBase<TChannel>)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
Open()	Provoque la transition d'un objet ClientBase<TChannel> de l'état créé à l'état ouvert. (Hérité de ClientBase<TChannel>)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

ICommunicationObject.BeginClose(AsyncCallback, Object)	Commence une opération asynchrone pour fermer l'objet ClientBase<TChannel>. (Hérité de ClientBase<TChannel>)
ICommunicationObject.BeginClose(TimeSpan, AsyncCallback, Object)	Commence une opération asynchrone pour fermer l'objet ClientBase<TChannel> dans un délai d'attente spécifié. (Hérité de ClientBase<TChannel>)
ICommunicationObject.BeginOpen(AsyncCallback, Object)	Commence une opération asynchrone pour ouvrir l'objet ClientBase<TChannel>. (Hérité de ClientBase<TChannel>)
ICommunicationObject.BeginOpen(TimeSpan, AsyncCallback, Object)	Commence une opération asynchrone pour ouvrir l'objet ClientBase<TChannel> dans un intervalle de temps spécifié. (Hérité de ClientBase<TChannel>)
ICommunicationObject.Close()	Provoque la transition d'un objet de communication de son état actuel à l'état fermé. (Hérité de ClientBase<TChannel>)
ICommunicationObject.Close(TimeSpan)	Provoque la transition d'un objet ClientBase<TChannel> de son état actuel à l'état fermé. (Hérité de ClientBase<TChannel>)
ICommunicationObject.Closed	Gestionnaire d'événements appelé lorsque l'objet ClientBase<TChannel> est passé de son état actuel à l'état fermé. (Hérité de ClientBase<TChannel>)
ICommunicationObject.Closing	Gestionnaire d'événements appelé lorsque l'objet ClientBase<TChannel> passe de son état actuel à l'état fermé. (Hérité de ClientBase<TChannel>)
ICommunicationObject.EndClose(IAsyncResult)	Clôture une opération asynchrone pour fermer l'objet ClientBase<TChannel>. (Hérité de ClientBase<TChannel>)
ICommunicationObject.EndOpen(IAsyncResult)	Clôture une opération asynchrone pour ouvrir l'objet ClientBase<TChannel>. (Hérité de ClientBase<TChannel>)
ICommunicationObject.Faulted	Gestionnaire d'événements appelé lorsqu'une erreur se produit lors de l'exécution d'une opération sur l'objet ClientBase<TChannel>. (Hérité de ClientBase<TChannel>)
ICommunicationObject.Open()	Provoque la transition d'un objet de communication de l'état créé à l'état ouvert. (Hérité de ClientBase<TChannel>)
ICommunicationObject.Open(TimeSpan)	Provoque la transition d'un objet ClientBase<TChannel> de l'état créé à l'état ouvert dans un intervalle de temps spécifié. (Hérité de ClientBase<TChannel>)
ICommunicationObject.Opened	Gestionnaire d'événements appelé lors de la transition de l'objet ClientBase<TChannel> de l'état créé à l'état ouvert. (Hérité de ClientBase<TChannel>)
ICommunicationObject.Opening	Gestionnaire d'événements appelé lors de la transition de l'objet ClientBase<TChannel> de l'état créé à l'état ouvert. (Hérité de ClientBase<TChannel>)
IDisposable.Dispose()	Implémentation explicite de la méthode Dispose(). (Hérité de ClientBase<TChannel>)

S’applique à