CallbackDebugBehavior.IncludeExceptionDetailInFaults Propriété

Définition

Espace de noms:

System.ServiceModel.Description

Assembly:

System.ServiceModel.Primitives.dll

Paquet:

System.ServiceModel.Primitives v8.0.0

Source:

CallbackDebugBehavior.cs

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.

public:
 property bool IncludeExceptionDetailInFaults { bool get(); void set(bool value); };

public bool IncludeExceptionDetailInFaults { get; set; }

member this.IncludeExceptionDetailInFaults : bool with get, set

Public Property IncludeExceptionDetailInFaults As Boolean

Valeur de propriété

Boolean

true si WCF retourne des informations d’exception de rappel de client managé dans les erreurs SOAP à des fins de débogage de service dans la communication duplex ; sinon, false. La valeur par défaut est false.

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.

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

Attention

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.

Pour activer ou désactiver une fonctionnalité de CallbackDebugBehavior par le biais d’un fichier de configuration

1. Ajoutez un behaviorConfiguration attribut à l’élément de point de terminaison> client< pour votre application cliente WCF. Le comportement CallbackDebugBehavior est un comportement de point de terminaison. Les comportements de point de terminaison sont configurés sur <endpoint> les éléments ; les comportements de service sont configurés sur les <éléments de service> .

2. Ajoutez ou créez une <section endpointBehaviors> et ajoutez un <élément de comportement> à celle avec le nom correspondant à la valeur d’attribut de l’étape behaviorConfiguration 1. Les comportements de point de terminaison sont ajoutés pour une utilisation dans un élément de point de terminaison> client< à l’aide d’un <élément endpointBehaviors>.

3. Ajoutez un <élément callbackDebug> à l’élément behavior> de l’étape< 2 et activez ou désactivez les différentes propriétés appropriées à votre scénario.

Pour obtenir un exemple spécifique, consultez la section Exemple. 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.