CallbackDebugBehavior Classe

Définition

Espace de noms:

System.ServiceModel.Description

Assembly:

System.ServiceModel.Primitives.dll

Paquet:

System.ServiceModel.Primitives v8.1.1

Source:

CallbackDebugBehavior.cs

Active le débogage de service pour un objet de rappel Windows Communication Foundation (WCF).

C#

public class CallbackDebugBehavior : System.ServiceModel.Description.IEndpointBehavior

Héritage

Object

CallbackDebugBehavior

Implémente

IEndpointBehavior

Exemples

L’exemple de code suivant illustre un fichier de configuration client qui fait en sorte que WCF retourne des informations sur les exceptions managées à partir d’un objet de rappel client dans des messages SOAP.

XML

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

Remarques

Affectez la valeur IncludeExceptionDetailInFaults à la propriété true à partir d'un fichier de configuration de l'application ou par programme afin d'activer le flux d'informations sur les exceptions managées dans un objet de rappel client au service à des fins de débogage.

Précaution

Le retour d'informations sur les exceptions managées aux services peut constituer un problème de sécurité, car les détails d'exception exposent des informations relatives à l'implémentation cliente interne que des services non autorisés pourraient utiliser. De plus, bien que les propriétés CallbackDebugBehavior puissent également être définies par programme, il peut être facile d'oublier de désactiver IncludeExceptionDetailInFaults lors du déploiement.

Étant donné les problèmes de sécurité impliqués, il est vivement recommandé :

• d'utiliser un fichier de configuration d'application pour affecter à la propriété IncludeExceptionDetailInFaults la valeur true ;

• de ne procéder ainsi que dans des scénarios de débogage contrôlés.

Pour plus d’informations sur les problèmes de sécurité liés aux informations d’exception managées, consultez Spécification et gestion des erreurs dans les contrats et services.

Vous pouvez également définir les valeurs de cet attribut à l’aide de l’élément <callbackDebug> dans un fichier de configuration d’application cliente.

Constructeurs

CallbackDebugBehavior(Boolean)

Initialise une nouvelle instance de la classe CallbackDebugBehavior.

Propriétés

IncludeExceptionDetailInFaults

Obtient ou définit une valeur qui détermine si les objets de rappel client retournent au service des informations sur les exceptions managées dans les erreurs SOAP.

Implémentations d’interfaces explicites

IEndpointBehavior.AddBindingParameters(ServiceEndpoint, BindingParameterCollection)	Implémente la méthode AddBindingParameters(ServiceEndpoint, BindingParameterCollection) afin de prendre en charge le comportement.
IEndpointBehavior.ApplyClientBehavior(ServiceEndpoint, ClientRuntime)	Implémente ApplyClientBehavior(ServiceEndpoint, ClientRuntime) afin de prendre en charge le comportement.
IEndpointBehavior.ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher)	Implémente ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher) afin de prendre en charge le comportement.
IEndpointBehavior.Validate(ServiceEndpoint)	Implémente Validate(ServiceEndpoint) afin de prendre en charge le comportement.

S’applique à