CallbackDebugBehavior CallbackDebugBehavior CallbackDebugBehavior CallbackDebugBehavior Class

定義

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

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
継承
CallbackDebugBehaviorCallbackDebugBehaviorCallbackDebugBehaviorCallbackDebugBehavior
実装

次のコード例は、クライアントをクライアントからのマネージ例外情報をコールバック オブジェクト返す SOAP メッセージでの WCF に指示する構成ファイルを示します。The following code example shows a client configuration file that instructs WCF to return managed exception information from a client callback object in SOAP messages.

  <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 に設定して、デバッグするために、クライアント コールバック オブジェクト内のマネージド例外情報がサービスに戻るフローを有効にします。Set the IncludeExceptionDetailInFaults property to true from an application configuration file or programmatically to enable the flow of managed exception information in a client callback object back to the service for debugging purposes.

注意事項

マネージド例外情報をサービスに戻すことは、セキュリティ リスクになり得ます。これは、例外の詳細が、非承認のサービスで使用可能な内部クライアントの実装についての情報を公開するからです。Returning managed exception information to services can be a security risk because exception details expose information about the internal client implementation that could be used by unauthorized services. さらに、CallbackDebugBehavior プロパティをプログラムで設定することはできますが、配置するときに IncludeExceptionDetailInFaults を無効にすることを忘れがちになります。In addition, although the CallbackDebugBehavior properties can also be set programmatically, it can be easy to forget to disable IncludeExceptionDetailInFaults when deploying.

セキュリティの問題にかかわるので、以下を強くお勧めします。Because of the security issues involved, it is strongly recommended that:

  • IncludeExceptionDetailInFaults プロパティの値を true に設定するには、アプリケーション構成ファイルを使用します。You use an application configuration file to set the value of the IncludeExceptionDetailInFaults property to true.

  • これは、制御されたデバッグ シナリオの場合に限って行います。You only do so only in controlled debugging scenarios.

マネージ例外情報に関連するセキュリティの問題に関する詳細については、次を参照してください。を指定すると処理のエラー コントラクトおよびサービスのします。For more information about the security issues related to managed exception information, see Specifying and Handling Faults in Contracts and Services.

使用して、この属性の値を設定することも、 <callbackDebug> クライアント アプリケーションの構成ファイル内の要素。You can also set the values of this attribute by using the <callbackDebug> element in a client application configuration file.

コンストラクター

CallbackDebugBehavior(Boolean) CallbackDebugBehavior(Boolean) CallbackDebugBehavior(Boolean) CallbackDebugBehavior(Boolean)

CallbackDebugBehavior クラスの新しいインスタンスを初期化します。Initializes a new instance of the CallbackDebugBehavior class.

プロパティ

IncludeExceptionDetailInFaults IncludeExceptionDetailInFaults IncludeExceptionDetailInFaults IncludeExceptionDetailInFaults

クライアント コールバック オブジェクトが SOAP エラー内のマネージド例外情報をサービスに返すかどうかを制御する値を取得または設定します。Gets or sets a value that controls whether client callback objects return managed exception information in SOAP faults back to the service.

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

IEndpointBehavior.AddBindingParameters(ServiceEndpoint, BindingParameterCollection) IEndpointBehavior.AddBindingParameters(ServiceEndpoint, BindingParameterCollection) IEndpointBehavior.AddBindingParameters(ServiceEndpoint, BindingParameterCollection) IEndpointBehavior.AddBindingParameters(ServiceEndpoint, BindingParameterCollection)

AddBindingParameters(ServiceEndpoint, BindingParameterCollection) メソッドを実装して動作をサポートします。Implements the AddBindingParameters(ServiceEndpoint, BindingParameterCollection) method to support the behavior.

IEndpointBehavior.ApplyClientBehavior(ServiceEndpoint, ClientRuntime) IEndpointBehavior.ApplyClientBehavior(ServiceEndpoint, ClientRuntime) IEndpointBehavior.ApplyClientBehavior(ServiceEndpoint, ClientRuntime) IEndpointBehavior.ApplyClientBehavior(ServiceEndpoint, ClientRuntime)

ApplyClientBehavior(ServiceEndpoint, ClientRuntime) を実装して動作をサポートします。Implements the ApplyClientBehavior(ServiceEndpoint, ClientRuntime) to support the behavior.

IEndpointBehavior.ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher) IEndpointBehavior.ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher) IEndpointBehavior.ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher) IEndpointBehavior.ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher)

ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher) を実装して動作をサポートします。Implements the ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher) to support the behavior.

IEndpointBehavior.Validate(ServiceEndpoint) IEndpointBehavior.Validate(ServiceEndpoint) IEndpointBehavior.Validate(ServiceEndpoint) IEndpointBehavior.Validate(ServiceEndpoint)

Validate(ServiceEndpoint) を実装して動作をサポートします。Implements Validate(ServiceEndpoint) to support the behavior.

メソッド

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)

適用対象