DuplexClientBase<TChannel> Klasa

Definicja

Przestrzeń nazw:

System.ServiceModel

Zestaw:

System.ServiceModel.Primitives.dll

Pakiet:

System.ServiceModel.Primitives v8.0.0

Źródło:

DuplexClientBase.cs

Służy do tworzenia kanału w usłudze dwukierunkowej i kojarzenia tego kanału z obiektem wywołania zwrotnego.

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

public abstract 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)

Parametry typu

TChannel

Typ kanału do utworzenia.

Dziedziczenie

Object

ClientBase<TChannel>

DuplexClientBase<TChannel>

Przykłady

W poniższym przykładzie pokazano użycie w kliencie typu klienta dwukierunkowego programu WCF, SampleDuplexHelloClient, aby przekazać nowy obiekt System.ServiceModel.InstanceContext z obiektem wywołania zwrotnego w celu nasłuchiwania wywołań zwrotnych.

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

Uwagi

Użyj klasy DuplexClientBase<TChannel>, aby utworzyć kanał do usługi, która określa obiekt wywołania zwrotnego. Obiekt DuplexClientBase<TChannel> opakowuje obiekt System.ServiceModel.DuplexChannelFactory<TChannel>, który zapewnia łączność dla obiektu WCF. Możesz użyć dowolnego typu, aby nawiązać połączenie z usługą dwukierunkową. Aby uzyskać więcej informacji na temat usług dwukierunkowych, zobacz Usług dwudupleksowych.

Szczególna uwaga dla użytkowników zarządzanego języka C++ pochodnych z tej klasy:

• Umieść kod oczyszczania w (On)(Begin)Close (i/lub OnAbort), a nie w destruktora.

• Unikaj destruktorów: powodują one automatyczne generowanie IDisposable przez kompilator

• Unikaj elementów członkowskich innych niż odwołania: mogą powodować automatyczne generowanie IDisposable przez kompilator

• Unikaj finalizatorów; ale jeśli go uwzględnisz, należy pominąć ostrzeżenie kompilacji i wywołać SuppressFinalize(Object) i sam finalizator z (On)(Begin)Close (i/lub OnAbort) w celu emulowania tego, co byłoby generowane automatycznie IDisposable zachowanie.

Konstruktory

DuplexClientBase<TChannel>(InstanceContext)	Inicjuje nowe wystąpienie klasy DuplexClientBase<TChannel> przy użyciu określonego obiektu wywołania zwrotnego.
DuplexClientBase<TChannel>(InstanceContext, Binding, EndpointAddress)	Inicjuje nowe wystąpienie klasy DuplexClientBase<TChannel> przy użyciu określonego obiektu wywołania zwrotnego, powiązania i adresu punktu końcowego usługi.

Właściwości

Channel	Pobiera kanał wewnętrzny używany do wysyłania komunikatów do różnych skonfigurowanych punktów końcowych usługi. (Odziedziczone po ClientBase<TChannel>)
ChannelFactory	Pobiera podstawowy obiekt ChannelFactory<TChannel>. (Odziedziczone po ClientBase<TChannel>)
ClientCredentials	Pobiera poświadczenia klienta używane do wywoływania operacji. (Odziedziczone po ClientBase<TChannel>)
Endpoint	Pobiera docelowy punkt końcowy usługi, z którą klient programu WCF może nawiązać połączenie. (Odziedziczone po ClientBase<TChannel>)
InnerChannel	Pobiera podstawową implementację IClientChannel. (Odziedziczone po ClientBase<TChannel>)
State	Pobiera bieżący stan obiektu ClientBase<TChannel>. (Odziedziczone po ClientBase<TChannel>)

Metody

Abort()	Powoduje, że obiekt ClientBase<TChannel> przechodzi natychmiast ze stanu bieżącego do stanu zamkniętego. (Odziedziczone po ClientBase<TChannel>)
Close()	Powoduje przejście obiektu ClientBase<TChannel> z bieżącego stanu do stanu zamkniętego. (Odziedziczone po ClientBase<TChannel>)
CloseAsync()	Służy do tworzenia kanału w usłudze dwukierunkowej i kojarzenia tego kanału z obiektem wywołania zwrotnego. (Odziedziczone po ClientBase<TChannel>)
CreateChannel()	Zwraca nowy kanał do usługi. (Odziedziczone po ClientBase<TChannel>)
DisplayInitializationUI()	Instruuje wewnętrzny kanał, aby wyświetlić interfejs użytkownika, jeśli jest wymagany do zainicjowania kanału przed jego użyciem. (Odziedziczone po ClientBase<TChannel>)
Equals(Object)	Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object)
GetDefaultValueForInitialization<T>()	Replikuje zachowanie domyślnego słowa kluczowego w języku C#. (Odziedziczone po ClientBase<TChannel>)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
InvokeAsync(ClientBase<TChannel>.BeginOperationDelegate, Object[], ClientBase<TChannel>.EndOperationDelegate, SendOrPostCallback, Object)	Zapewnia obsługę implementowania wzorca asynchronicznego opartego na zdarzeniach. Aby uzyskać więcej informacji na temat tego wzorca, zobacz Asynchroniczny wzorzec oparty na zdarzeniach — omówienie. (Odziedziczone po ClientBase<TChannel>)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
Open()	Powoduje przejście obiektu ClientBase<TChannel> z utworzonego stanu do stanu otwartego. (Odziedziczone po ClientBase<TChannel>)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Jawne implementacje interfejsu

IAsyncDisposable.DisposeAsync()	Służy do tworzenia kanału w usłudze dwukierunkowej i kojarzenia tego kanału z obiektem wywołania zwrotnego. (Odziedziczone po ClientBase<TChannel>)
ICommunicationObject.BeginClose(AsyncCallback, Object)	Rozpoczyna operację asynchroniczną, aby zamknąć ClientBase<TChannel>. (Odziedziczone po ClientBase<TChannel>)
ICommunicationObject.BeginClose(TimeSpan, AsyncCallback, Object)	Rozpoczyna operację asynchroniczną, aby zamknąć ClientBase<TChannel> z określonym limitem czasu. (Odziedziczone po ClientBase<TChannel>)
ICommunicationObject.BeginOpen(AsyncCallback, Object)	Rozpoczyna operację asynchroniczną, aby otworzyć obiekt ClientBase<TChannel>. (Odziedziczone po ClientBase<TChannel>)
ICommunicationObject.BeginOpen(TimeSpan, AsyncCallback, Object)	Rozpoczyna operację asynchroniczną, aby otworzyć obiekt ClientBase<TChannel> w określonym przedziale czasu. (Odziedziczone po ClientBase<TChannel>)
ICommunicationObject.Close()	Powoduje przejście obiektu komunikacyjnego z bieżącego stanu do stanu zamkniętego. (Odziedziczone po ClientBase<TChannel>)
ICommunicationObject.Close(TimeSpan)	Powoduje przejście obiektu ClientBase<TChannel> z bieżącego stanu do stanu zamkniętego. (Odziedziczone po ClientBase<TChannel>)
ICommunicationObject.Closed	Procedura obsługi zdarzeń wywoływana po przejściu obiektu ClientBase<TChannel> z bieżącego stanu do stanu zamkniętego. (Odziedziczone po ClientBase<TChannel>)
ICommunicationObject.Closing	Procedura obsługi zdarzeń wywoływana, gdy obiekt ClientBase<TChannel> przechodzi z bieżącego stanu do stanu zamkniętego. (Odziedziczone po ClientBase<TChannel>)
ICommunicationObject.EndClose(IAsyncResult)	Wykonuje operację asynchroniczną, aby zamknąć obiekt ClientBase<TChannel>. (Odziedziczone po ClientBase<TChannel>)
ICommunicationObject.EndOpen(IAsyncResult)	Wykonuje operację asynchroniczną, aby otworzyć obiekt ClientBase<TChannel>. (Odziedziczone po ClientBase<TChannel>)
ICommunicationObject.Faulted	Procedura obsługi zdarzeń wywoływana w przypadku wystąpienia błędu podczas wykonywania operacji na obiekcie ClientBase<TChannel>. (Odziedziczone po ClientBase<TChannel>)
ICommunicationObject.Open()	Powoduje przejście obiektu komunikacyjnego ze stanu utworzonego na otwarty stan. (Odziedziczone po ClientBase<TChannel>)
ICommunicationObject.Open(TimeSpan)	Powoduje przejście obiektu ClientBase<TChannel> z utworzonego stanu do otwartego stanu w określonym przedziale czasu. (Odziedziczone po ClientBase<TChannel>)
ICommunicationObject.Opened	Procedura obsługi zdarzeń wywoływana, gdy obiekt ClientBase<TChannel> przechodzi ze stanu utworzonego na otwarty. (Odziedziczone po ClientBase<TChannel>)
ICommunicationObject.Opening	Procedura obsługi zdarzeń wywoływana, gdy obiekt ClientBase<TChannel> przechodzi ze stanu utworzonego na otwarty. (Odziedziczone po ClientBase<TChannel>)
IDisposable.Dispose()	Jawna implementacja metody Dispose(). (Odziedziczone po ClientBase<TChannel>)

Metody rozszerzania

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguruje, w jaki sposób będą wykonywane oczekiwania na zadania zwrócone z asynchronicznego jednorazowego użytku.