CallbackDebugBehavior Класс

Определение

Задает отладку службы для объекта обратного вызова службы Windows Communication Foundation (WCF).

public class CallbackDebugBehavior : System.ServiceModel.Description.IEndpointBehavior
Наследование
CallbackDebugBehavior
Реализации

Примеры

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

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

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

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

Конструкторы

CallbackDebugBehavior(Boolean)

Инициализирует новый экземпляр класса CallbackDebugBehavior.

Свойства

IncludeExceptionDetailInFaults

Возвращает или задает значение, которое определяет, возвращают ли объекты обратного вызова сведения об управляемом исключении в ошибках SOAP обратно в службу.

Методы

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)

Явные реализации интерфейса

IEndpointBehavior.AddBindingParameters(ServiceEndpoint, BindingParameterCollection)

Реализует метод AddBindingParameters(ServiceEndpoint, BindingParameterCollection) для поддержки расширения функциональности.

IEndpointBehavior.ApplyClientBehavior(ServiceEndpoint, ClientRuntime)

Реализует метод ApplyClientBehavior(ServiceEndpoint, ClientRuntime) для поддержки поведения.

IEndpointBehavior.ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher)

Реализует метод ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher) для поддержки поведения.

IEndpointBehavior.Validate(ServiceEndpoint)

Реализует метод Validate(ServiceEndpoint) для поддержки поведения.

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

Продукт Версии
.NET 8 (package-provided)
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7 (package-provided), 4.7, 4.7.1 (package-provided), 4.7.1, 4.7.2 (package-provided), 4.7.2, 4.8 (package-provided), 4.8, 4.8.1
.NET Standard 2.0 (package-provided)