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

ApplyClientBehavior メソッド

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

すべて縮小

言語フィルタ

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

Microsoft Visual Studio 2008/.NET Framework 3.5

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

.NET Framework クラスライブラリ

IContractBehavior..::.ApplyClientBehavior メソッド

更新 : 2007 年 11 月

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

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

構文

Visual Basic (宣言)

Sub ApplyClientBehavior ( _
    contractDescription As ContractDescription, _
    endpoint As ServiceEndpoint, _
    clientRuntime As ClientRuntime _
)

Visual Basic (使用法)

Dim instance As IContractBehavior
Dim contractDescription As ContractDescription
Dim endpoint As ServiceEndpoint
Dim clientRuntime As ClientRuntime

instance.ApplyClientBehavior(contractDescription, _
    endpoint, clientRuntime)

void ApplyClientBehavior(
    ContractDescription contractDescription,
    ServiceEndpoint endpoint,
    ClientRuntime clientRuntime
)

Visual C++

void ApplyClientBehavior(
    ContractDescription^ contractDescription, 
    ServiceEndpoint^ endpoint, 
    ClientRuntime^ clientRuntime
)

void ApplyClientBehavior(
    ContractDescription contractDescription,
    ServiceEndpoint endpoint,
    ClientRuntime clientRuntime
)

JScript

function ApplyClientBehavior(
    contractDescription : ContractDescription, 
    endpoint : ServiceEndpoint, 
    clientRuntime : ClientRuntime
)

パラメータ

contractDescription: 型 : System.ServiceModel.Description..::.ContractDescription
拡張対象のコントラクトの説明。

endpoint: 型 : System.ServiceModel.Description..::.ServiceEndpoint
エンドポイント。

clientRuntime: 型 : System.ServiceModel.Dispatcher..::.ClientRuntime
クライアントランタイム。

解説

すべてのメッセージまたは特定の 1 つの操作について、クライアントランタイムを表示または変更したり、クライアントランタイムにカスタム拡張機能を追加したりするには、ApplyClientBehavior メソッドを実装します。クライアントのランタイムオブジェクトで実行できるカスタマイズの詳細については、ClientRuntime および ClientOperation を参照してください。

動作をサービスアプリケーションでのみ使用する場合は、ApplyClientBehavior メソッドで NotImplementedException 例外をスローさせることができます。

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

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

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

例

次のコード例は、カスタムの 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
}