ServiceDebugBehavior Класс

Определение

public ref class ServiceDebugBehavior : System::ServiceModel::Description::IServiceBehavior

public class ServiceDebugBehavior : System.ServiceModel.Description.IServiceBehavior

type ServiceDebugBehavior = class
    interface IServiceBehavior

Public Class ServiceDebugBehavior
Implements IServiceBehavior

Наследование

Object

ServiceDebugBehavior

Реализации

IServiceBehavior

Примеры

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

Комментарии

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

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

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

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

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

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

HttpsHelpPageEnabled И HttpHelpPageEnabled свойства указывают службе публиковать HTML-файлы справки при просмотре службы с помощью браузера HTML.

HttpsHelpPageUrl Свойства HttpHelpPageUrl управляют расположением страницы справки HTML, которая просматривается.

Чтобы включить или отключить одну из ServiceDebugBehavior функций с помощью файла конфигурации, выполните следующие действия.

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

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

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

Пример см. в разделе "Пример".