DuplexChannelFactory<TChannel> クラス

定義

名前空間:

System.ServiceModel

アセンブリ:

System.ServiceModel.Primitives.dll

パッケージ:

System.ServiceModel.Primitives v8.0.0

ソース:

DuplexChannelFactory.cs

サービス エンドポイントとの間でメッセージを送受信するためにクライアントによって使用されるさまざまな種類の双方向チャネルを作成および管理する手段を提供します。

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)

型パラメーター

TChannel

チャネル ファクトリによって生成されるチャネルの種類。

継承

Object

CommunicationObject

ChannelFactory

ChannelFactory<TChannel>

DuplexChannelFactory<TChannel>

派生

System.ServiceModel.Configuration.ConfigurationDuplexChannelFactory<TChannel>

例

次の例では、チャネル ファクトリを作成し、それを使用してチャネルを作成および管理する方法を示します。

// 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);
        }
    }

注釈

双方向チャネルを使用すると、クライアントとサーバーは互いに独立して通信できるため、どちらか一方のクライアントが相互に呼び出しを開始できます。 双方向サービスは、イベントに似た動作を提供して、クライアント エンドポイントにメッセージを送信できます。 双方向通信は、クライアントがサービスとのセッションを確立し、サービスがクライアントにメッセージを送信できるチャネルをサービスに提供するときに発生します。 これらの双方向チャネルを作成するには、さまざまな CreateChannel メソッドが使用されます。 双方向メッセージ パターンは、Windows Communication Foundation (WCF) サービスで使用できる 3 つのメッセージ パターンの 1 つです。 他の 2 つのメッセージ パターンは、一方向と要求/応答です。

クライアントがサービスに接続できるようにする双方向サービスの一般的な説明については、「双方向サービスの」を参照してください。 チャネル ファクトリを使用して Windows Communication Foundation (WCF) クライアント アプリケーションを作成する手順の概要と説明については、「方法: ChannelFactoryを使用する」を参照してください。 双方向メッセージング パターンを使用するサービスにアクセスするためのコールバック インターフェイスを実装するクライアント クラスで Windows Communication Foundation (WCF) クライアントを作成する方法を説明する手順については、「方法: 双方向コントラクトを使用してサービスにアクセスする」を参照してください。

コンストラクター

DuplexChannelFactory<TChannel>(InstanceContext, Binding)	コールバック コントラクトと指定したバインディングを実装するコンテキストを使用して、DuplexChannelFactory<TChannel> クラスの新しいインスタンスを初期化します。
DuplexChannelFactory<TChannel>(InstanceContext, Binding, EndpointAddress)	コールバック コントラクトを実装するオブジェクトと、指定したバインディングとエンドポイント アドレスを使用して、DuplexChannelFactory<TChannel> クラスの新しいインスタンスを初期化します。
DuplexChannelFactory<TChannel>(InstanceContext, Binding, String)	指定したインスタンス コンテキスト、バインディング、およびリモート アドレスを使用して、DuplexChannelFactory<TChannel> クラスの新しいインスタンスを初期化します。
DuplexChannelFactory<TChannel>(Type)	指定した型のコールバック インスタンスを使用して、DuplexChannelFactory<TChannel> クラスの新しいインスタンスを初期化します。
DuplexChannelFactory<TChannel>(Type, Binding)	指定した型のコールバック インスタンスとバインドを使用して、DuplexChannelFactory<TChannel> クラスの新しいインスタンスを初期化します。
DuplexChannelFactory<TChannel>(Type, Binding, EndpointAddress)	指定した種類のコールバック インスタンス、バインディング、およびリモート アドレスを使用して、DuplexChannelFactory<TChannel> クラスの新しいインスタンスを初期化します。
DuplexChannelFactory<TChannel>(Type, Binding, String)	指定した種類のコールバック インスタンス、バインディング、およびリモート アドレスを使用して、DuplexChannelFactory<TChannel> クラスの新しいインスタンスを初期化します。
DuplexChannelFactory<TChannel>(Type, ServiceEndpoint)	指定した種類のコールバック インスタンスとサービス エンドポイントを使用して、DuplexChannelFactory<TChannel> クラスの新しいインスタンスを初期化します。

プロパティ

Credentials	ファクトリによって生成されたチャネルを介してサービス エンドポイントを通信するためにクライアントによって使用される資格情報を取得します。 (継承元 ChannelFactory)
DefaultCloseTimeout	閉じる操作が完了するまでに指定された既定の時間間隔を取得します。 (継承元 ChannelFactory)
DefaultOpenTimeout	開いている操作が完了するまでに指定された既定の時間間隔を取得します。 (継承元 ChannelFactory)
Endpoint	ファクトリによって生成されたチャネルが接続するサービス エンドポイントを取得します。 (継承元 ChannelFactory)
IsDisposed	通信オブジェクトが破棄されたかどうかを示す値を取得します。 (継承元 CommunicationObject)
State	通信オブジェクトの現在の状態を示す値を取得します。 (継承元 CommunicationObject)
ThisLock	状態遷移中にクラス インスタンスを保護する相互排他的ロックを取得します。 (継承元 CommunicationObject)

メソッド

Abort()	通信オブジェクトを現在の状態から終了状態に直ちに遷移させます。 (継承元 CommunicationObject)
ApplyConfiguration(String)	指定した構成ファイルによって提供される動作と、チャネル ファクトリのサービス エンドポイント内の動作を使用して、チャネル ファクトリを初期化します。 (継承元 ChannelFactory)
BeginClose(AsyncCallback, Object)	通信オブジェクトを閉じる非同期操作を開始します。 (継承元 CommunicationObject)
BeginClose(TimeSpan, AsyncCallback, Object)	指定したタイムアウトで通信オブジェクトを閉じる非同期操作を開始します。 (継承元 CommunicationObject)
BeginOpen(AsyncCallback, Object)	通信オブジェクトを開く非同期操作を開始します。 (継承元 CommunicationObject)
BeginOpen(TimeSpan, AsyncCallback, Object)	指定した時間内に通信オブジェクトを開く非同期操作を開始します。 (継承元 CommunicationObject)
Close()	通信オブジェクトを現在の状態から閉じた状態に遷移させます。 (継承元 CommunicationObject)
Close(TimeSpan)	指定した時間内に、通信オブジェクトを現在の状態から閉じた状態に遷移させます。 (継承元 CommunicationObject)
CreateChannel()	指定した種類のチャネルを、指定したエンドポイント アドレスに作成します。 (継承元 ChannelFactory<TChannel>)
CreateChannel(EndpointAddress)	特定のエンドポイント アドレスでサービスにメッセージを送信するために使用されるチャネルを作成します。 (継承元 ChannelFactory<TChannel>)
CreateChannel(EndpointAddress, Uri)	サービスとクライアント上のコールバック インスタンスの間に双方向チャネルを作成します。
CreateChannel(InstanceContext)	サービスとクライアント上のコールバック インスタンスの間に双方向チャネルを作成します。
CreateChannel(InstanceContext, EndpointAddress)	サービスとクライアント上のコールバック インスタンスの間に双方向チャネルを作成します。
CreateChannel(InstanceContext, EndpointAddress, Uri)	サービスとクライアント上のコールバック インスタンスの間に双方向チャネルを作成します。
CreateChannelWithActAsToken(SecurityToken)	セキュリティ トークンとしての動作を使用してサービスにメッセージを送信するために使用されるチャネルを作成します。 (継承元 ChannelFactory<TChannel>)
CreateChannelWithActAsToken(SecurityToken, EndpointAddress)	特定のエンドポイント アドレスでセキュリティ トークンとして機能するサービスにメッセージを送信するために使用されるチャネルを作成します。 (継承元 ChannelFactory<TChannel>)
CreateChannelWithActAsToken(SecurityToken, EndpointAddress, Uri)	指定したトランスポート アドレスを介して、特定のエンドポイント アドレスでセキュリティ トークンとして機能するサービスにメッセージを送信するために使用されるチャネルを作成します。 (継承元 ChannelFactory<TChannel>)
CreateChannelWithIssuedToken(SecurityToken)	発行されたセキュリティ トークンを使用してサービスにメッセージを送信するために使用されるチャネルを作成します。 (継承元 ChannelFactory<TChannel>)
CreateChannelWithIssuedToken(SecurityToken, EndpointAddress)	特定のエンドポイント アドレスで発行されたセキュリティ トークンを使用してサービスにメッセージを送信するために使用されるチャネルを作成します。 (継承元 ChannelFactory<TChannel>)
CreateChannelWithIssuedToken(SecurityToken, EndpointAddress, Uri)	指定したトランスポート アドレスを介して、特定のエンドポイント アドレスで発行されたセキュリティ トークンを使用してサービスにメッセージを送信するために使用されるチャネルを作成します。 (継承元 ChannelFactory<TChannel>)
CreateChannelWithOnBehalfOfToken(SecurityToken)	セキュリティ トークンの代理としてサービスにメッセージを送信するために使用されるチャネルを作成します。 (継承元 ChannelFactory<TChannel>)
CreateChannelWithOnBehalfOfToken(SecurityToken, EndpointAddress)	特定のエンドポイント アドレスでセキュリティ トークンに代わってサービスにメッセージを送信するために使用されるチャネルを作成します。 (継承元 ChannelFactory<TChannel>)
CreateChannelWithOnBehalfOfToken(SecurityToken, EndpointAddress, Uri)	指定したトランスポート アドレスを介して、特定のエンドポイント アドレスでセキュリティ トークンの代理としてサービスにメッセージを送信するために使用されるチャネルを作成します。 (継承元 ChannelFactory<TChannel>)
CreateDescription()	サービス エンドポイントの説明を作成します。 (継承元 ChannelFactory<TChannel>)
CreateFactory()	ファクトリの現在のエンドポイントのチャネル ファクトリをビルドします。 (継承元 ChannelFactory)
EndClose(IAsyncResult)	通信オブジェクトを閉じる非同期操作を完了します。 (継承元 CommunicationObject)
EndOpen(IAsyncResult)	通信オブジェクトを開く非同期操作を完了します。 (継承元 CommunicationObject)
EnsureOpened()	現在のチャネル ファクトリがまだ開いていない場合は開きます。 (継承元 ChannelFactory)
Equals(Object)	指定したオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
Fault()	通信オブジェクトを現在の状態から障害状態に遷移させます。 (継承元 CommunicationObject)
GetCommunicationObjectType()	通信オブジェクトの種類を取得します。 (継承元 CommunicationObject)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetProperty<T>()	チャネル スタック内の適切なレイヤーから要求された型指定されたオブジェクトを返します。存在しない場合は null します。 (継承元 ChannelFactory)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
InitializeEndpoint(Binding, EndpointAddress)	指定したバインディングとアドレスを使用して、チャネル ファクトリのサービス エンドポイントを初期化します。 (継承元 ChannelFactory)
InitializeEndpoint(ServiceEndpoint)	指定したエンドポイントを使用して、チャネル ファクトリのサービス エンドポイントを初期化します。 (継承元 ChannelFactory)
InitializeEndpoint(String, EndpointAddress)	指定したアドレスと構成を使用して、チャネル ファクトリのサービス エンドポイントを初期化します。 (継承元 ChannelFactory)
MemberwiseClone()	現在の Objectの簡易コピーを作成します。 (継承元 Object)
OnAbort()	現在のチャネル ファクトリの内部チャネル ファクトリを終了します。 (継承元 ChannelFactory)
OnBeginClose(TimeSpan, AsyncCallback, Object)	状態オブジェクトが関連付けられている現在のチャネル ファクトリの内部チャネル ファクトリで非同期の閉じる操作を開始します。 (継承元 ChannelFactory)
OnBeginOpen(TimeSpan, AsyncCallback, Object)	状態オブジェクトが関連付けられている現在のチャネル ファクトリの内部チャネル ファクトリで、非同期のオープン操作を開始します。 (継承元 ChannelFactory)
OnClose(TimeSpan)	操作を完了するために、指定されたタイムアウトで内部チャネル ファクトリで close を呼び出します。 (継承元 ChannelFactory)
OnClosed()	通信オブジェクトの終了状態への遷移中に呼び出されます。 (継承元 CommunicationObject)
OnClosing()	通信オブジェクトの終了状態への遷移中に呼び出されます。 (継承元 CommunicationObject)
OnEndClose(IAsyncResult)	現在のチャネル ファクトリの内部チャネル ファクトリで非同期の閉じる操作を完了します。 (継承元 ChannelFactory)
OnEndOpen(IAsyncResult)	現在のチャネル ファクトリの内部チャネル ファクトリで非同期のオープン操作を完了します。 (継承元 ChannelFactory)
OnFaulted()	同期障害操作の呼び出しにより、通信オブジェクトが障害状態に遷移した後に、処理を挿入します。 (継承元 CommunicationObject)
OnOpen(TimeSpan)	現在のチャネル ファクトリの内部チャネル ファクトリで開く呼び出しで、操作を完了するためのタイムアウトを指定します。 (継承元 ChannelFactory)
OnOpened()	チャネル ファクトリの ClientCredentials オブジェクトの読み取り専用コピーを初期化します。 (継承元 ChannelFactory)
OnOpening()	現在のチャネルの内部チャネル ファクトリを構築します。 (継承元 ChannelFactory)
Open()	通信オブジェクトが作成された状態から開かれた状態に遷移します。 (継承元 CommunicationObject)
Open(TimeSpan)	指定した時間内に、通信オブジェクトが作成された状態から開かれた状態に遷移します。 (継承元 CommunicationObject)
ThrowIfDisposed()	通信オブジェクトが破棄された場合に例外をスローします。 (継承元 CommunicationObject)
ThrowIfDisposedOrImmutable()	State プロパティが Created 状態に設定されていない通信オブジェクトの場合は、例外をスローします。 (継承元 CommunicationObject)
ThrowIfDisposedOrNotOpen()	通信オブジェクトが Opened 状態でない場合は、例外をスローします。 (継承元 CommunicationObject)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

イベント

Closed	通信オブジェクトが閉じた状態に遷移したときに発生します。 (継承元 CommunicationObject)
Closing	通信オブジェクトが終了状態に遷移したときに発生します。 (継承元 CommunicationObject)
Faulted	通信オブジェクトが障害状態に遷移したときに発生します。 (継承元 CommunicationObject)
Opened	通信オブジェクトが開かれた状態に遷移したときに発生します。 (継承元 CommunicationObject)
Opening	通信オブジェクトが開始状態に遷移したときに発生します。 (継承元 CommunicationObject)

明示的なインターフェイスの実装

IAsyncDisposable.DisposeAsync()	サービス エンドポイントとの間でメッセージを送受信するためにクライアントによって使用されるさまざまな種類の双方向チャネルを作成および管理する手段を提供します。 (継承元 ChannelFactory)
IDisposable.Dispose()	現在のチャネル ファクトリを閉じます。 (継承元 ChannelFactory)

拡張メソッド

ConfigureAwait(IAsyncDisposable, Boolean)

非同期破棄から返されるタスクの待機を実行する方法を構成します。