DuplexChannelFactory<TChannel> Třída

Definice

Obor názvů:

System.ServiceModel

Sestavení:

System.ServiceModel.Primitives.dll

Balíček:

System.ServiceModel.Primitives v8.0.0

Zdroj:

DuplexChannelFactory.cs

Poskytuje prostředky pro vytváření a správu duplexních kanálů různých typů, které klienti používají k odesílání a přijímání zpráv do a z koncových bodů služby.

generic <typename TChannel>
public ref class DuplexChannelFactory : System::ServiceModel::ChannelFactory<TChannel>

public class DuplexChannelFactory<TChannel> : System.ServiceModel.ChannelFactory<TChannel>

type DuplexChannelFactory<'Channel> = class
    inherit ChannelFactory<'Channel>

Public Class DuplexChannelFactory(Of TChannel)
Inherits ChannelFactory(Of TChannel)

Parametry typu

TChannel

Typ kanálu vytvořeného továrnou kanálu.

Dědičnost

Object

CommunicationObject

ChannelFactory

ChannelFactory<TChannel>

DuplexChannelFactory<TChannel>

Odvozené

System.ServiceModel.Configuration.ConfigurationDuplexChannelFactory<TChannel>

Příklady

Následující ukázka ukazuje, jak vytvořit objekt pro vytváření kanálů a používat ho k vytváření a správě kanálů.

// Construct InstanceContext to handle messages on the callback interface.
// An instance of ChatApp is created and passed to the InstanceContext.
    InstanceContext site = new InstanceContext(new ChatApp());

// Create the participant with the given endpoint configuration.
// Each participant opens a duplex channel to the mesh.
// Participant is an instance of the chat application that has opened a channel to the mesh.

    using (DuplexChannelFactory<IChatChannel> cf =
        new DuplexChannelFactory<IChatChannel>(site,"ChatEndpoint"))
    {
        X509Certificate2 issuer = GetCertificate(
            StoreName.CertificateAuthority,
            StoreLocation.CurrentUser, "CN=" + issuerName,
            X509FindType.FindBySubjectDistinguishedName);
        cf.Credentials.Peer.Certificate =
            GetCertificate(StoreName.My,
            StoreLocation.CurrentUser,
            "CN=" + member,
            X509FindType.FindBySubjectDistinguishedName);
        cf.Credentials.Peer.PeerAuthentication.CertificateValidationMode  =
            X509CertificateValidationMode.Custom;
        cf.Credentials.Peer.PeerAuthentication.CustomCertificateValidator =
            new IssuerBasedValidator();

        using (IChatChannel participant = cf.CreateChannel())
        {
    // Retrieve the PeerNode associated with the participant and register for online/offline events.
    // PeerNode represents a node in the mesh. Mesh is the named collection of connected nodes.
            IOnlineStatus ostat = participant.GetProperty<IOnlineStatus>();
            ostat.Online += new EventHandler(OnOnline);
            ostat.Offline += new EventHandler(OnOffline);

            Console.WriteLine("{0} is ready", member);
            Console.WriteLine("Press <ENTER> to send the chat message.");

    // Announce self to other participants.
            participant.Join(member);
            Console.ReadLine();
            participant.Chat(member, "Hi there - I am chatting");

            Console.WriteLine("Press <ENTER> to terminate this instance of chat.");
            Console.ReadLine();
    // Leave the mesh and close the client.
            participant.Leave(member);
        }
    }

Poznámky

Duplexní kanál umožňuje klientům a serverům komunikovat nezávisle na sobě, aby buď mohly zahájit volání druhé. Duplexní služba může posílat zprávy do koncového bodu klienta a poskytovat chování podobné události. Duplexní komunikace nastane, když klient vytvoří relaci se službou a poskytne službě kanál, na kterém může služba odesílat zprávy zpět klientovi. K vytvoření těchto duplexního kanálu se používají různé CreateChannel metody. Model duplexní zprávy je jedním ze tří vzorů zpráv, které jsou k dispozici pro služby WCF (Windows Communication Foundation). Další dva vzory zpráv jsou jednosměrná a žádost-odpověď.

Obecné informace o duplexních službách, které klientům umožňují připojit se zpět ke službě, najdete v tématu Duplex Services. Osnovu a diskuzi o krocích, které se týkají psaní klientské aplikace WCF (Windows Communication Foundation) pomocí objektu pro vytváření kanálů, najdete v tématu Postupy: PoužitíChannelFactory . Postup popisující, jak vytvořit klienta WCF (Windows Communication Foundation) ve třídě klienta, která implementuje rozhraní zpětného volání pro přístup ke službě, která používá vzor duplexního zasílání zpráv, najdete v tématu Postupy: Přístup ke službám pomocí duplexního kontraktu.

Konstruktory

DuplexChannelFactory<TChannel>(InstanceContext, Binding)	Inicializuje novou instanci DuplexChannelFactory<TChannel> třídy s kontextem, který implementuje kontrakt zpětného volání a zadanou vazbu.
DuplexChannelFactory<TChannel>(InstanceContext, Binding, EndpointAddress)	Inicializuje novou instanci DuplexChannelFactory<TChannel> třídy s objektem, který implementuje kontrakt zpětného volání a zadanou vazbu a adresu koncového bodu.
DuplexChannelFactory<TChannel>(InstanceContext, Binding, String)	Inicializuje novou instanci třídy DuplexChannelFactory<TChannel> se zadaným kontextem instance, vazbou a vzdálenou adresou.
DuplexChannelFactory<TChannel>(Type)	Inicializuje novou instanci třídy DuplexChannelFactory<TChannel> se zadaným typem instance zpětného volání.
DuplexChannelFactory<TChannel>(Type, Binding)	Inicializuje novou instanci DuplexChannelFactory<TChannel> třídy se zadaným typem instance zpětného volání a vazby.
DuplexChannelFactory<TChannel>(Type, Binding, EndpointAddress)	Inicializuje novou instanci DuplexChannelFactory<TChannel> třídy se zadaným typem instance zpětného volání, vazby a vzdálené adresy.
DuplexChannelFactory<TChannel>(Type, Binding, String)	Inicializuje novou instanci DuplexChannelFactory<TChannel> třídy se zadaným typem instance zpětného volání, vazby a vzdálené adresy.
DuplexChannelFactory<TChannel>(Type, ServiceEndpoint)	Inicializuje novou instanci DuplexChannelFactory<TChannel> třídy se zadaným typem instance zpětného volání a koncového bodu služby.

Vlastnosti

Credentials	Získá přihlašovací údaje používané klienty ke komunikaci koncového bodu služby přes kanály vytvořené továrnou. (Zděděno od ChannelFactory)
DefaultCloseTimeout	Získá výchozí interval času zadaný pro dokončení operace uzavření. (Zděděno od ChannelFactory)
DefaultOpenTimeout	Získá výchozí časový interval zadaný pro dokončení otevřené operace. (Zděděno od ChannelFactory)
Endpoint	Získá koncový bod služby, ke kterému se kanály vytvořené továrnou připojují. (Zděděno od ChannelFactory)
IsDisposed	Získá hodnotu, která označuje, zda komunikační objekt byl uvolněn. (Zděděno od CommunicationObject)
State	Získá hodnotu, která označuje aktuální stav komunikačního objektu. (Zděděno od CommunicationObject)
ThisLock	Získá vzájemně vylučující zámek, který chrání instanci třídy během přechodu stavu. (Zděděno od CommunicationObject)

Metody

Abort()	Způsobí, že komunikační objekt přejde okamžitě z aktuálního stavu do koncového stavu. (Zděděno od CommunicationObject)
ApplyConfiguration(String)	Inicializuje objekt pro vytváření kanálů chování poskytnutým zadaným konfiguračním souborem a s těmi, které jsou v koncovém bodu služby objektu pro vytváření kanálů. (Zděděno od ChannelFactory)
BeginClose(AsyncCallback, Object)	Zahájí asynchronní operaci ukončení komunikačního objektu. (Zděděno od CommunicationObject)
BeginClose(TimeSpan, AsyncCallback, Object)	Zahájí asynchronní operaci ukončení komunikačního objektu se zadaným časovým limitem. (Zděděno od CommunicationObject)
BeginOpen(AsyncCallback, Object)	Zahájí asynchronní operaci otevření komunikačního objektu. (Zděděno od CommunicationObject)
BeginOpen(TimeSpan, AsyncCallback, Object)	Zahájí asynchronní operaci otevření komunikačního objektu v zadaném časovém intervalu. (Zděděno od CommunicationObject)
Close()	Způsobí přechod komunikačního objektu z jeho aktuálního stavu do uzavřeného stavu. (Zděděno od CommunicationObject)
Close(TimeSpan)	Způsobí, že komunikační objekt přejde z aktuálního stavu do uzavřeného stavu v zadaném časovém intervalu. (Zděděno od CommunicationObject)
CreateChannel()	Vytvoří kanál zadaného typu na zadanou adresu koncového bodu. (Zděděno od ChannelFactory<TChannel>)
CreateChannel(EndpointAddress)	Vytvoří kanál, který se používá k odesílání zpráv do služby na konkrétní adrese koncového bodu. (Zděděno od ChannelFactory<TChannel>)
CreateChannel(EndpointAddress, Uri)	Vytvoří duplexní kanál mezi službou a instancí zpětného volání v klientovi.
CreateChannel(InstanceContext)	Vytvoří duplexní kanál mezi službou a instancí zpětného volání v klientovi.
CreateChannel(InstanceContext, EndpointAddress)	Vytvoří duplexní kanál mezi službou a instancí zpětného volání v klientovi.
CreateChannel(InstanceContext, EndpointAddress, Uri)	Vytvoří duplexní kanál mezi službou a instancí zpětného volání v klientovi.
CreateChannelWithActAsToken(SecurityToken)	Vytvoří kanál, který se používá k odesílání zpráv do služby pomocí tokenu zabezpečení. (Zděděno od ChannelFactory<TChannel>)
CreateChannelWithActAsToken(SecurityToken, EndpointAddress)	Vytvoří kanál, který se používá k odesílání zpráv do služby s použitím tokenu zabezpečení na konkrétní adrese koncového bodu. (Zděděno od ChannelFactory<TChannel>)
CreateChannelWithActAsToken(SecurityToken, EndpointAddress, Uri)	Vytvoří kanál, který se používá k odesílání zpráv do služby pomocí tokenu zabezpečení na konkrétní adrese koncového bodu prostřednictvím zadané přenosové adresy. (Zděděno od ChannelFactory<TChannel>)
CreateChannelWithIssuedToken(SecurityToken)	Vytvoří kanál, který se používá k odesílání zpráv do služby s vystaveným tokenem zabezpečení. (Zděděno od ChannelFactory<TChannel>)
CreateChannelWithIssuedToken(SecurityToken, EndpointAddress)	Vytvoří kanál, který se používá k odesílání zpráv do služby s vystaveným tokenem zabezpečení na konkrétní adrese koncového bodu. (Zděděno od ChannelFactory<TChannel>)
CreateChannelWithIssuedToken(SecurityToken, EndpointAddress, Uri)	Vytvoří kanál, který se používá k odesílání zpráv do služby s vydaným tokenem zabezpečení na konkrétní adrese koncového bodu prostřednictvím zadané přenosové adresy. (Zděděno od ChannelFactory<TChannel>)
CreateChannelWithOnBehalfOfToken(SecurityToken)	Vytvoří kanál, který se používá k odesílání zpráv službě jménem tokenu zabezpečení. (Zděděno od ChannelFactory<TChannel>)
CreateChannelWithOnBehalfOfToken(SecurityToken, EndpointAddress)	Vytvoří kanál, který se používá k odesílání zpráv službě jménem tokenu zabezpečení na konkrétní adrese koncového bodu. (Zděděno od ChannelFactory<TChannel>)
CreateChannelWithOnBehalfOfToken(SecurityToken, EndpointAddress, Uri)	Vytvoří kanál, který se používá k odesílání zpráv službě jménem tokenu zabezpečení na konkrétní adrese koncového bodu prostřednictvím zadané přenosové adresy. (Zděděno od ChannelFactory<TChannel>)
CreateDescription()	Vytvoří popis koncového bodu služby. (Zděděno od ChannelFactory<TChannel>)
CreateFactory()	Vytvoří objekt pro vytváření kanálů pro aktuální koncový bod továrny. (Zděděno od ChannelFactory)
EndClose(IAsyncResult)	Dokončí asynchronní operaci pro zavření komunikačního objektu. (Zděděno od CommunicationObject)
EndOpen(IAsyncResult)	Dokončí asynchronní operaci pro otevření komunikačního objektu. (Zděděno od CommunicationObject)
EnsureOpened()	Otevře aktuální objekt pro vytváření kanálů, pokud ještě není otevřený. (Zděděno od ChannelFactory)
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
Fault()	Způsobí přechod komunikačního objektu z jeho aktuálního stavu do chybného stavu. (Zděděno od CommunicationObject)
GetCommunicationObjectType()	Získá typ komunikačního objektu. (Zděděno od CommunicationObject)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetProperty<T>()	Vrátí požadovaný typ objektu z příslušné vrstvy v zásobníku kanálu nebo null, pokud není k dispozici. (Zděděno od ChannelFactory)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
InitializeEndpoint(Binding, EndpointAddress)	Inicializuje koncový bod služby objektu pro vytváření kanálů se zadanou vazbou a adresou. (Zděděno od ChannelFactory)
InitializeEndpoint(ServiceEndpoint)	Inicializuje koncový bod služby objektu pro vytváření kanálů se zadaným koncovým bodem. (Zděděno od ChannelFactory)
InitializeEndpoint(String, EndpointAddress)	Inicializuje koncový bod služby objektu pro vytváření kanálů se zadanou adresou a konfigurací. (Zděděno od ChannelFactory)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
OnAbort()	Ukončí objekt pro vytváření vnitřních kanálů aktuální továrny kanálu. (Zděděno od ChannelFactory)
OnBeginClose(TimeSpan, AsyncCallback, Object)	Zahájí asynchronní operaci uzavření v objektu pro vnitřní kanál objektu pro vytváření aktuálního kanálu, který má přidružený objekt stavu. (Zděděno od ChannelFactory)
OnBeginOpen(TimeSpan, AsyncCallback, Object)	Zahájí asynchronní otevřenou operaci v objektu pro vytváření vnitřních kanálů objektu pro vytváření aktuálního kanálu, který má přidružený objekt stavu. (Zděděno od ChannelFactory)
OnClose(TimeSpan)	Volání se zavře v objektu pro vnitřní kanál s určeným časovým limitem pro dokončení operace. (Zděděno od ChannelFactory)
OnClosed()	Vyvoláno během přechodu komunikačního objektu do koncového stavu. (Zděděno od CommunicationObject)
OnClosing()	Vyvoláno během přechodu komunikačního objektu do koncového stavu. (Zděděno od CommunicationObject)
OnEndClose(IAsyncResult)	Dokončí asynchronní operaci uzavření v objektu pro vytváření vnitřních kanálů aktuálního kanálu. (Zděděno od ChannelFactory)
OnEndOpen(IAsyncResult)	Dokončí asynchronní otevřenou operaci ve vnitřní továrně kanálu aktuální továrny kanálu. (Zděděno od ChannelFactory)
OnFaulted()	Vloží zpracování na komunikační objekt poté, co přejde do chybného stavu kvůli vyvolání synchronní operace selhání. (Zděděno od CommunicationObject)
OnOpen(TimeSpan)	Volání otevřená v objektu pro vytváření vnitřních kanálů aktuálního kanálu s určeným časovým limitem pro dokončení operace. (Zděděno od ChannelFactory)
OnOpened()	Inicializuje kopii objektu ClientCredentials jen pro čtení pro objekt kanálu. (Zděděno od ChannelFactory)
OnOpening()	Vytvoří objekt pro vytváření vnitřních kanálů pro aktuální kanál. (Zděděno od ChannelFactory)
Open()	Způsobí, že komunikační objekt přejde z vytvořeného stavu do otevřeného stavu. (Zděděno od CommunicationObject)
Open(TimeSpan)	Způsobí, že komunikační objekt přejde z vytvořeného stavu do otevřeného stavu v zadaném časovém intervalu. (Zděděno od CommunicationObject)
ThrowIfDisposed()	Vyvolá výjimku, pokud je komunikační objekt uvolněn. (Zděděno od CommunicationObject)
ThrowIfDisposedOrImmutable()	Vyvolá výjimku, pokud komunikační objekt State vlastnost není nastaven na Created stav. (Zděděno od CommunicationObject)
ThrowIfDisposedOrNotOpen()	Vyvolá výjimku, pokud komunikační objekt není v Opened stavu. (Zděděno od CommunicationObject)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Událost

Closed	Nastane, když komunikační objekt přejde do uzavřeného stavu. (Zděděno od CommunicationObject)
Closing	Nastane, když komunikační objekt přejde do koncového stavu. (Zděděno od CommunicationObject)
Faulted	Nastane, když komunikační objekt přejde do chybného stavu. (Zděděno od CommunicationObject)
Opened	Nastane, když komunikační objekt přejde do otevřeného stavu. (Zděděno od CommunicationObject)
Opening	Nastane, když komunikační objekt přejde do stavu otevření. (Zděděno od CommunicationObject)

Explicitní implementace rozhraní

IAsyncDisposable.DisposeAsync()	Poskytuje prostředky pro vytváření a správu duplexních kanálů různých typů, které klienti používají k odesílání a přijímání zpráv do a z koncových bodů služby. (Zděděno od ChannelFactory)
IDisposable.Dispose()	Zavře aktuální objekt pro vytváření kanálů. (Zděděno od ChannelFactory)

Metody rozšíření

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguruje, jak čekají na úlohy vrácené z asynchronního jednorázového použití.