ServiceDebugBehavior.IncludeExceptionDetailInFaults Свойство

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

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

true Значение , если Windows Communication Foundation (WCF) возвращает сведения об управляемом исключении в ошибках SOAP для целей отладки клиента; falseв противном случае . Значение по умолчанию — false.

Примеры

В следующем примере кода показано, как использовать файл конфигурации для включения функции справки HTML и возврата сведений об исключении внутри ошибки SOAP клиенту в целях отладки. В этом файле конфигурации показаны следующие основные шаги по добавлению поддержки ServiceDebugBehavior функций:

• ServiceDebugBehavior Так как тип является System.ServiceModel.Description.IServiceBehavior реализацией, элемент службы<, представляющий тип службы,> имеет идентификатор behaviorConfiguration="metadataAndDebug"конфигурации поведения.

• Опять же, так как ServiceDebugBehavior тип является System.ServiceModel.Description.IServiceBehavior реализацией <элемента поведения> , добавляется в <раздел serviceBehaviors> . name Задайте атрибут <элемента поведения>, значение которого является идентификатором behaviorConfiguration атрибута <элемента службы>. В этом случае значение равно metadataAndDebug.

• <Добавьте элемент serviceDebug> с различными атрибутами, заданными для требуемой конфигурации. В этом случае для значений httpHelpPageEnabledincludeExceptionDetailInFaults атрибутов задано значение true.

<configuration>
  <system.serviceModel>
    <services>
      <!-- 
        Step 1. Add a behaviorConfiguration attribute
        in the <service> element.
      -->
      <service 
        name="Microsoft.WCF.Documentation.SampleService"
        behaviorConfiguration="metadataAndDebug">
        <host>
          <baseAddresses>
            <add baseAddress="http://localhost:8080/SampleService" />
          </baseAddresses>
        </host>
        <endpoint
          address=""
          binding="wsHttpBinding"
          contract="Microsoft.WCF.Documentation.ISampleService"
        />
        <endpoint
           address="mex"
           binding="mexHttpBinding"
           contract="IMetadataExchange"
        />
      </service>
    </services>
    <behaviors>
      <serviceBehaviors>
        <!-- 
          Step 2. Inside a <serviceBehaviors> section, add 
          a name attribute in the <behaviors> element that 
          matches the behaviorConfiguration attribute in the
          <service> element above.
        -->
        <behavior name="metadataAndDebug">
          <serviceMetadata 
            httpGetEnabled="true" 
            httpGetUrl=""
          />
          <!-- 
            Step 3. Add a <serviceDebug> element and 
            modify the various attributes that suit your 
            scenario.
          -->
          <serviceDebug 
            httpHelpPageEnabled="true" 
            includeExceptionDetailInFaults="true"
          />
        </behavior>
      </serviceBehaviors>
    </behaviors>
  </system.serviceModel>
</configuration>

Комментарии

IncludeExceptionDetailInFaults Присвойте свойству указание true WCF возвращать сведения об управляемом исключении клиенту в сбоях SOAP, чтобы упростить отладку.

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

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

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

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