CallbackDebugBehavior クラス

定義

名前空間:

System.ServiceModel.Description

アセンブリ:

System.ServiceModel.Primitives.dll

パッケージ:

System.ServiceModel.Primitives v8.0.0

ソース:

CallbackDebugBehavior.cs

Windows Communication Foundation (WCF) コールバック オブジェクトのサービス デバッグを実行できるようにします。

public ref class CallbackDebugBehavior : System::ServiceModel::Description::IEndpointBehavior

public class CallbackDebugBehavior : System.ServiceModel.Description.IEndpointBehavior

type CallbackDebugBehavior = class
    interface IEndpointBehavior

Public Class CallbackDebugBehavior
Implements IEndpointBehavior

継承

Object

CallbackDebugBehavior

実装

IEndpointBehavior

例

SOAP メッセージのクライアント コールバック オブジェクトからマネージド例外情報を返すように WCF に指示するクライアント構成ファイルを次のコード例に示します。

  <client>
      <endpoint 
        address="http://localhost:8080/DuplexHello" 
        binding="wsDualHttpBinding"
        bindingConfiguration="WSDualHttpBinding_SampleDuplexHello"
        contract="SampleDuplexHello" 
        name="WSDualHttpBinding_SampleDuplexHello"
        behaviorConfiguration="enableCallbackDebug">
      </endpoint>
  </client>
<behaviors>
  <endpointBehaviors>
    <behavior name="enableCallbackDebug">
      <callbackDebug includeExceptionDetailInFaults="true"/>
    </behavior>
  </endpointBehaviors>
</behaviors>

注釈

アプリケーション構成ファイルまたはプログラムから、IncludeExceptionDetailInFaults プロパティを true に設定して、デバッグするために、クライアント コールバック オブジェクト内のマネージド例外情報がサービスに戻るフローを有効にします。

注意事項

マネージド例外情報をサービスに戻すことは、セキュリティ リスクになり得ます。これは、例外の詳細が、非承認のサービスで使用可能な内部クライアントの実装についての情報を公開するからです。 さらに、CallbackDebugBehavior プロパティをプログラムで設定することはできますが、配置するときに IncludeExceptionDetailInFaults を無効にすることを忘れがちになります。

セキュリティの問題にかかわるので、以下を強くお勧めします。

• IncludeExceptionDetailInFaults プロパティの値を true に設定するには、アプリケーション構成ファイルを使用します。

• これは、制御されたデバッグ シナリオの場合に限って行います。

マネージド例外情報に関連するセキュリティの問題の詳細については、「 コントラクトとサービスでのエラーの指定と処理」を参照してください。

クライアント アプリケーション構成ファイルで callbackDebug> 要素を使用して、<この属性の値を設定することもできます。

コンストラクター

CallbackDebugBehavior(Boolean)

CallbackDebugBehavior クラスの新しいインスタンスを初期化します。

プロパティ

IncludeExceptionDetailInFaults

クライアント コールバック オブジェクトが SOAP エラー内のマネージド例外情報をサービスに返すかどうかを制御する値を取得または設定します。

メソッド

Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

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

IEndpointBehavior.AddBindingParameters(ServiceEndpoint, BindingParameterCollection)	AddBindingParameters(ServiceEndpoint, BindingParameterCollection) メソッドを実装して動作をサポートします。
IEndpointBehavior.ApplyClientBehavior(ServiceEndpoint, ClientRuntime)	ApplyClientBehavior(ServiceEndpoint, ClientRuntime) を実装して動作をサポートします。
IEndpointBehavior.ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher)	ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher) を実装して動作をサポートします。
IEndpointBehavior.Validate(ServiceEndpoint)	Validate(ServiceEndpoint) を実装して動作をサポートします。