DispatchRuntime クラス

定義

public ref class DispatchRuntime sealed

public sealed class DispatchRuntime

type DispatchRuntime = class

Public NotInheritable Class DispatchRuntime

継承

Object

DispatchRuntime

注釈

DispatchRuntime クラスは、サービスまたは個別のエンドポイントの既定動作を変更するため、またはカスタム変更を実装したオブジェクトを次のサービス プロセスの一方または両方に挿入するために使用します。

1. 受信メッセージをオブジェクトに変換し、メソッド呼び出しとしてサービス オブジェクト上でそれらのオブジェクトを解放します。

2. サービス操作呼び出しに対する応答から受信したオブジェクトを送信メッセージに変換します。

Windows Communication Foundation (WCF) では、チャネルディスパッチャーとエンドポイント ディスパッチャーは、新しいチャネルの受け入れ、メッセージの受信、メソッドのディスパッチと呼び出し、応答処理を担当するサービス コンポーネントです。 ServiceHost オブジェクトによって公開される各エンドポイントには、1 つのエンドポイント ディスパッチャーと、関連付けられた 1 つのチャネル ディスパッチャーがあります。さらに、双方向通信に参加する各クライアントには、各コールバック エンドポイントのエンドポイント ディスパッチャーとチャネル ディスパッチャーもあります。

DispatchRuntime を使用すると、メッセージが認識されない場合でも、特定のコントラクト全体のすべてのメッセージについて、特定のチャネルまたはエンドポイント ディスパッチャーを途中受信および拡張できます。 コントラクト内で宣言されているどのメッセージとも一致しないメッセージが到着すると、UnhandledDispatchOperation プロパティにより返された操作にディスパッチされます。 特定の操作についてすべてのメッセージを途中受信または拡張する方法については、DispatchOperation クラスを参照してください。

DispatchRuntime クラスによって公開されているディスパッチャー拡張性は次の 4 つの領域に大別できます。

1. ディスパッチ コンポーネントは、DispatchRuntime のプロパティおよび ChannelDispatcher プロパティによって返される関連チャネル ディスパッチャーのプロパティを使用して、チャネル ディスパッチャーがチャネルを受け入れてクローズする方法をカスタマイズします。 この分類に属するプロパティとして、ChannelInitializers プロパティおよび InputSessionShutdownHandlers があります。

2. メッセージ コンポーネントを、処理されるメッセージごとにカスタマイズします。 この分類に属するプロパティとして、MessageInspectors、OperationSelector、Operations、ErrorHandlers があります。

3. インスタンス コンポーネントが、特定のサービス型のインスタンスの作成、有効期間、破棄をカスタマイズします。 サービス オブジェクトの有効期間の詳細については、InstanceContextMode プロパティを参照してください。 このカテゴリには、InstanceContextInitializers プロパティおよび InstanceProvider プロパティが含まれます。

4. セキュリティ関連コンポーネントは、次のプロパティを使用できます。

   • SecurityAuditLogLocation は、監査イベントが出力される場所を示します。

   • ImpersonateCallerForAllOperations は、サービスが受信メッセージによって提供される資格情報を使用して偽装を試みるかどうかを制御します。

   • MessageAuthenticationAuditLevel は、SecurityAuditLogLocation によって指定されたイベント ログに、メッセージ認証成功イベントを出力するかどうかを制御します。

   • PrincipalPermissionMode は、CurrentPrincipal プロパティの設定方法を制御します。

   • ServiceAuthorizationAuditLevel は、承認イベントの監査の実行方法を指定します。

   • SuppressAuditFailure は、ログ記録処理中に発生した致命的でない例外を抑制するかどうかを指定します。

カスタムの拡張オブジェクトは通常、DispatchRuntime プロパティに割り当てるか、またはサービス動作 (IServiceBehavior を実装するオブジェクト)、契約動作 (IContractBehavior を実装するオブジェクト)、エンドポイント動作 (IEndpointBehavior を実装するオブジェクト) のいずれかによってコレクションに挿入します。 次に、インストール動作オブジェクトを、プログラムで直接、またはカスタムの BehaviorExtensionElement オブジェクトを実装して適切な動作コレクションに追加し、アプリケーション構成ファイルを使用して動作を挿入できるようにします。

プロパティ

メソッド

適用対象