CallbackDebugBehavior Klasse

Referenz

Definition

Namespace:: System.ServiceModel.Description

Assembly:: System.ServiceModel.Primitives.dll

Assembly:: System.ServiceModel.dll

Paket:: System.ServiceModel.Primitives v8.0.0

Quelle:: CallbackDebugBehavior.cs

Quelle:: CallbackDebugBehavior.cs

Quelle:: CallbackDebugBehavior.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ermöglicht das Debuggen von Diensten für ein WCF-Rückrufobjekt (Windows Communication Foundation).

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

Vererbung: Object
CallbackDebugBehavior

Implementiert: IEndpointBehavior

Beispiele

Das folgende Codebeispiel zeigt eine Clientkonfigurationsdatei, die WCF anweist, verwaltete Ausnahmeinformationen von einem Clientrückrufobjekt in SOAP-Nachrichten zurückzugeben.

  <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>

Hinweise

Legen Sie die IncludeExceptionDetailInFaults-Eigenschaft über eine Anwendungskonfigurationsdatei oder programmgesteuert auf true fest, um den Fluss verwalteter Ausnahmeinformationen in einem Client-Rückrufobjekt zurück zum Dienst für Debuggingzwecke zu aktivieren.

Achtung

Verwaltete Ausnahmeinformationen an Dienste zurückzugeben kann ein Sicherheitsrisiko darstellen, da Ausnahmedetails Informationen zur internen Clientimplementierung offen legen, die von nicht autorisierten Diensten verwendet werden können. Außerdem wird, obwohl die CallbackDebugBehavior-Eigenschaften auch programmgesteuert festgelegt werden können, bei der Bereitstellung das Deaktivieren von IncludeExceptionDetailInFaults schnell vergessen.

Wegen der damit verbundenen Sicherheitsprobleme wird Folgendes dringend empfohlen:

Verwenden Sie eine Anwendungskonfigurationsdatei, um den Wert der IncludeExceptionDetailInFaults-Eigenschaft auf true festzulegen.
Führen Sie diesen Vorgang nur in gesteuerten Debugszenarien aus.

Weitere Informationen zu den Sicherheitsproblemen im Zusammenhang mit Informationen zu verwalteten Ausnahmen finden Sie unter Angeben und Behandeln von Fehlern in Verträgen und Diensten.

Sie können die Werte dieses Attributs auch mithilfe des <callbackDebug-Elements> in einer Clientanwendungskonfigurationsdatei festlegen.

Konstruktoren

CallbackDebugBehavior(Boolean)

Initialisiert eine neue Instanz der CallbackDebugBehavior-Klasse.

Eigenschaften

IncludeExceptionDetailInFaults

Ruft einen Wert ab oder legt einen Wert fest, der steuert, ob Client-Rückrufobjekte verwaltete Ausnahmeinformationen in SOAP-Fehlern zurück an den Dienst geben.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

IEndpointBehavior.AddBindingParameters(ServiceEndpoint, BindingParameterCollection)	Implementiert die AddBindingParameters(ServiceEndpoint, BindingParameterCollection)-Methode zur Unterstützung des Verhaltens.
IEndpointBehavior.ApplyClientBehavior(ServiceEndpoint, ClientRuntime)	Implementiert ApplyClientBehavior(ServiceEndpoint, ClientRuntime) zur Unterstützung des Verhaltens.
IEndpointBehavior.ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher)	Implementiert ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher) zur Unterstützung des Verhaltens.
IEndpointBehavior.Validate(ServiceEndpoint)	Implementiert Validate(ServiceEndpoint) zur Unterstützung des Verhaltens.

Gilt für:

Freigeben über