CallbackDebugBehavior.IncludeExceptionDetailInFaults Свойство

Определение

Пространство имен:
System.ServiceModel.Description
Сборки:
System.ServiceModel.dll, System.ServiceModel.Primitives.dll
Сборка:
System.ServiceModel.dll
Сборка:
System.ServiceModel.Primitives.dll
Пакет:
System.ServiceModel.Primitives v10.0.652802
Исходный код:
CallbackDebugBehavior.cs
Исходный код:
CallbackDebugBehavior.cs
Исходный код:
CallbackDebugBehavior.cs

Возвращает или задает значение, определяющее, возвращают ли объекты обратного вызова клиента сведения об управляемом исключении в ошибках 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

Значение свойства

Boolean

true Если WCF возвращает сведения об исключении обратного вызова управляемого клиента в ошибках SOAP для отладки служб в дуплексном взаимодействии; falseв противном случае . Значение по умолчанию — false.

Примеры

В следующем примере кода показан файл конфигурации клиента, который указывает WCF возвращать сведения об управляемом исключении из объекта обратного вызова клиента в сообщениях 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>

Комментарии

IncludeExceptionDetailInFaults Задайте для свойства значение true из файла конфигурации приложения или программно, чтобы включить поток сведений об управляемом исключении в объекте обратного вызова клиента в службу для отладки.

Предостережение

Возврат сведений об управляемом исключении службам может быть угрозой безопасности, так как сведения об исключении предоставляют сведения о внутренней реализации клиента, которая может использоваться несанкционированными службами. Кроме того, хотя CallbackDebugBehavior свойства также могут быть заданы программным способом, при развертывании можно легко забыть отключить IncludeExceptionDetailInFaults .

Из-за проблем безопасности настоятельно рекомендуется:

  • Для задания значения IncludeExceptionDetailInFaults свойства trueиспользуется файл конфигурации приложения.

  • Это можно сделать только в управляемых сценариях отладки.

Дополнительные сведения о проблемах безопасности, связанных с сведениями об управляемых исключениях, см. в разделе "Указание и обработка ошибок в контрактах и службах".

Включение или отключение функции CallbackDebugBehavior с помощью файла конфигурации

  1. behaviorConfiguration Добавьте атрибут в элемент конечной точки> клиента< для клиентского приложения WCF. Поведение CallbackDebugBehavior — это поведение конечной точки. Поведение конечных точек настраивается на <endpoint> элементах; поведение службы настраивается на <элементах службы> .

  2. Добавьте или создайте <раздел endpointBehaviors> и добавьте <в нее элемент поведения> с именем, соответствующим значению атрибута behaviorConfiguration из шага 1. Поведение конечных точек добавляется для использования в элементе конечной точки> клиента< с помощью <элемента endpointBehaviors>.

  3. Добавьте элемент callbackDebug> в элемент поведения из шага 2 и включите или отключите различные свойства, соответствующие вашему сценарию.<><

Пример см. в разделе "Пример". Можно также задать значения этого атрибута с помощью <элемента callbackDebug> в файле конфигурации клиентского приложения.

Применяется к