IContractBehavior.ApplyDispatchBehavior メソッド (System.ServiceModel.Description)

ApplyDispatchBehavior メソッド

低帯域幅での表示をオンにする

すべて縮小

言語フィルタ

このページは次のバージョンについて記述しています。

Microsoft Visual Studio 2008/.NET Framework 3.5

その他のバージョンについては、以下の情報を参照してください。

.NET Framework クラスライブラリ

IContractBehavior..::.ApplyDispatchBehavior メソッド

更新 : 2007 年 11 月

コントラクト全体にわたってクライアントの変更または拡張を実装します。

名前空間 : System.ServiceModel.Description
アセンブリ : System.ServiceModel (System.ServiceModel.dll 内)

構文

Visual Basic (宣言)

Sub ApplyDispatchBehavior ( _
    contractDescription As ContractDescription, _
    endpoint As ServiceEndpoint, _
    dispatchRuntime As DispatchRuntime _
)

Visual Basic (使用法)

Dim instance As IContractBehavior
Dim contractDescription As ContractDescription
Dim endpoint As ServiceEndpoint
Dim dispatchRuntime As DispatchRuntime

instance.ApplyDispatchBehavior(contractDescription, _
    endpoint, dispatchRuntime)

void ApplyDispatchBehavior(
    ContractDescription contractDescription,
    ServiceEndpoint endpoint,
    DispatchRuntime dispatchRuntime
)

Visual C++

void ApplyDispatchBehavior(
    ContractDescription^ contractDescription, 
    ServiceEndpoint^ endpoint, 
    DispatchRuntime^ dispatchRuntime
)

void ApplyDispatchBehavior(
    ContractDescription contractDescription,
    ServiceEndpoint endpoint,
    DispatchRuntime dispatchRuntime
)

JScript

function ApplyDispatchBehavior(
    contractDescription : ContractDescription, 
    endpoint : ServiceEndpoint, 
    dispatchRuntime : DispatchRuntime
)

パラメータ

contractDescription: 型 : System.ServiceModel.Description..::.ContractDescription
変更するコントラクトの説明。

endpoint: 型 : System.ServiceModel.Description..::.ServiceEndpoint
コントラクトを公開するエンドポイント。

dispatchRuntime: 型 : System.ServiceModel.Dispatcher..::.DispatchRuntime
サービス実行を制御するディスパッチランタイム。

解説

特定のコントラクト内のすべてのメッセージまたはそのコントラクト内の特定の 1 つの操作について、サービスランタイムを表示または変更したり、サービスランタイムにカスタム拡張機能を追加したりするには、ApplyDispatchBehavior を実装します。サービスアプリケーションで実行できるカスタマイズの詳細については、DispatchRuntime および DispatchOperation を参照してください。

動作をクライアントアプリケーションでのみ使用する場合は、ApplyDispatchBehavior メソッドによって NotImplementedException 例外をスローすることができます。

このメソッドは、指定されたサービスコントラクトを使用するエンドポイントごとに 1 回呼び出されます。

説明 (各方向に 1 つずつ) では同じ名前の操作が 2 つ存在する場合がありますので注意してください。このため、双方向コントラクトで操作の反復が必要な場合は、エンドポイント DispatchRuntime と、CallbackClientRuntime プロパティによって返されるエンドポイント間で、メッセージの方向を関連付ける必要があります。

また、既に他の動作によって一部の操作が追加されるか、ランタイムから削除されている可能性があるので、Operations プロパティにある DispatchOperation オブジェクトと同じ数の操作が説明に存在するという保証はありません。

例

次のコード例は、カスタムの IInstanceProvider 実装が "シングルトン" 動作を提供する ObjectProviderBehavior を呼び出したことを前提としています。これは、常に同じサービスインスタンスを返し、リサイクルはしません。

インスタンスプロバイダのカスタマイズを挿入するために、例では、IContractBehavior を実装するカスタム属性 (SingletonBehaviorAttribute) を実装してカスタムサービスインスタンスプロバイダを挿入する方法を示しています。また、IContractBehaviorAttribute も実装します。これは、その使用を ISampleService コントラクトにバインドします。

public class SingletonBehaviorAttribute : Attribute, IContractBehaviorAttribute, IContractBehavior
{

  #region IContractBehaviorAttribute Members

  public Type TargetContract
  {
    get { return typeof(ISampleService); }
  }

  #endregion

  #region IContractBehavior Members

  public void AddBindingParameters(ContractDescription description, ServiceEndpoint endpoint, System.ServiceModel.Channels.BindingParameterCollection parameters)
  {
    return;
  }

  public void ApplyClientBehavior(ContractDescription description, ServiceEndpoint endpoint, ClientRuntime clientRuntime)
  {
    return;
  }

  public void ApplyDispatchBehavior(ContractDescription description, ServiceEndpoint endpoint, DispatchRuntime dispatch)
  {
    dispatch.InstanceProvider = new ObjectProviderBehavior("Custom ObjectProviderBehavior constructor.");
  }

  public void Validate(ContractDescription description, ServiceEndpoint endpoint)
  {
    return;
  }

  #endregion
}