ServiceDebugElement Класс

Определение

Пространство имен:: System.ServiceModel.Configuration

Сборка:: System.ServiceModel.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Представляет элемент конфигурации, указывающий функции отладки и справки для службы Windows Communication Foundation (WCF). Этот класс не может быть унаследован.

public ref class ServiceDebugElement sealed : System::ServiceModel::Configuration::BehaviorExtensionElement

public sealed class ServiceDebugElement : System.ServiceModel.Configuration.BehaviorExtensionElement

type ServiceDebugElement = class
    inherit BehaviorExtensionElement

Public NotInheritable Class ServiceDebugElement
Inherits BehaviorExtensionElement

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

ConfigurationElement

ServiceModelExtensionElement

BehaviorExtensionElement
ServiceDebugElement

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

ConfigurationElement

ServiceModelConfigurationElement

ServiceModelExtensionElement

BehaviorExtensionElement
ServiceDebugElement

Примеры

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

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

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

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

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

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

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

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

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

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

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

Свойства

Имя	Описание
BehaviorType	Возвращает тип этого элемента поведения.
ConfigurationElementName	Возвращает имя этого элемента конфигурации. (Унаследовано от ServiceModelExtensionElement)
CurrentConfiguration	Возвращает ссылку на экземпляр верхнего уровня Configuration , представляющий иерархию конфигурации, к которой принадлежит текущий ConfigurationElement экземпляр. (Унаследовано от ConfigurationElement)
ElementInformation	ElementInformation Возвращает объект, содержащий не настраиваемую информацию и функциональные возможности ConfigurationElement объекта. (Унаследовано от ConfigurationElement)
ElementProperty	ConfigurationElementProperty Возвращает объект, представляющий ConfigurationElement сам объект. (Унаследовано от ConfigurationElement)
EvaluationContext	Возвращает объект ContextInformation для объекта ConfigurationElement. (Унаследовано от ConfigurationElement)
HasContext	Возвращает значение, указывающее, является CurrentConfigurationли `null` свойство. (Унаследовано от ConfigurationElement)
HttpHelpPageBinding	Возвращает или задает строковое значение, указывающее привязку, используемую при использовании HTTP для доступа к странице справки службы.
HttpHelpPageBindingConfiguration	Возвращает или задает строку, указывающую на xml-раздел, определяющий дополнительные сведения о конфигурации привязки, указанной в HttpHelpPageBinding.
HttpHelpPageEnabled	Возвращает или задает значение, указывающее, публикует ли Windows Communication Foundation (WCF) страницу справки HTML по адресу, указанному свойством HttpHelpPageUrl .
HttpHelpPageUrl	Возвращает или задает расположение, в котором публикуется HTML-файл справки.
HttpsHelpPageBinding	Возвращает или задает строковое значение, указывающее привязку, используемую при использовании HTTPS для доступа к странице справки службы.
HttpsHelpPageBindingConfiguration	Возвращает или задает строку, указывающую на xml-раздел, определяющий дополнительные сведения о конфигурации привязки, указанной в HttpsHelpPageBinding.
HttpsHelpPageEnabled	Возвращает или задает значение, указывающее, возвращает ли Windows Communication Foundation (WCF) HTML-файл справки по протоколу HTTPS по адресу, указанному свойством HttpsHelpPageUrl .
HttpsHelpPageUrl	Возвращает или задает расположение, в котором публикуется HTML-файл справки для получения с помощью HTTPS.
IncludeExceptionDetailInFaults	Возвращает или задает значение, указывающее, следует ли включать сведения об управляемом исключении в подробные сведения об ошибках SOAP, возвращаемых клиенту в целях отладки.
Item[ConfigurationProperty]	Возвращает или задает свойство или атрибут этого элемента конфигурации. (Унаследовано от ConfigurationElement)
Item[String]	Возвращает или задает свойство, атрибут или дочерний элемент этого элемента конфигурации. (Унаследовано от ConfigurationElement)
LockAllAttributesExcept	Возвращает коллекцию заблокированных атрибутов. (Унаследовано от ConfigurationElement)
LockAllElementsExcept	Возвращает коллекцию заблокированных элементов. (Унаследовано от ConfigurationElement)
LockAttributes	Возвращает коллекцию заблокированных атрибутов. (Унаследовано от ConfigurationElement)
LockElements	Возвращает коллекцию заблокированных элементов. (Унаследовано от ConfigurationElement)
LockItem	Возвращает или задает значение, указывающее, заблокирован ли элемент. (Унаследовано от ConfigurationElement)
Properties	Возвращает коллекцию свойств. (Унаследовано от ConfigurationElement)

Методы

Имя	Описание
CopyFrom(ServiceModelExtensionElement)	Копирует содержимое указанного элемента конфигурации в этот элемент конфигурации.
CreateBehavior()	Создает расширение поведения на основе текущих параметров конфигурации. (Унаследовано от BehaviorExtensionElement)
DeserializeElement(XmlReader, Boolean)	Считывает XML из файла конфигурации. (Унаследовано от ConfigurationElement)
Equals(Object)	Сравнивает текущий ConfigurationElement экземпляр с указанным объектом. (Унаследовано от ConfigurationElement)
GetHashCode()	Возвращает уникальное значение, представляющее текущий ConfigurationElement экземпляр. (Унаследовано от ConfigurationElement)
GetTransformedAssemblyString(String)	Возвращает преобразованную версию указанного имени сборки. (Унаследовано от ConfigurationElement)
GetTransformedTypeString(String)	Возвращает преобразованную версию указанного имени типа. (Унаследовано от ConfigurationElement)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
Init()	Задает объект исходному ConfigurationElement состоянию. (Унаследовано от ConfigurationElement)
InitializeDefault()	Используется для инициализации набора значений по умолчанию для ConfigurationElement объекта. (Унаследовано от ConfigurationElement)
IsModified()	Возвращает значение, указывающее, был ли изменен этот элемент конфигурации. (Унаследовано от ServiceModelExtensionElement)
IsReadOnly()	Возвращает значение, указывающее, доступен ли ConfigurationElement объект только для чтения. (Унаследовано от ConfigurationElement)
ListErrors(IList)	Добавляет ошибки недопустимого свойства в этом ConfigurationElement объекте и во все подэлементы в переданный список. (Унаследовано от ConfigurationElement)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
OnDeserializeUnrecognizedAttribute(String, String)	Возвращает значение, указывающее, обнаружен ли неизвестный атрибут во время десериализации. (Унаследовано от ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Возвращает значение, указывающее, обнаружен ли неизвестный элемент во время десериализации. (Унаследовано от ConfigurationElement)
OnRequiredPropertyNotFound(String)	Создает исключение, если обязательное свойство не найдено. (Унаследовано от ConfigurationElement)
PostDeserialize()	Вызывается после десериализации. (Унаследовано от ConfigurationElement)
PreSerialize(XmlWriter)	Вызывается перед сериализацией. (Унаследовано от ConfigurationElement)
Reset(ConfigurationElement)	Сбрасывает внутреннее состояние этого объекта элемента конфигурации, включая блокировки и коллекции свойств. (Унаследовано от ServiceModelExtensionElement)
ResetModified()	Сбрасывает значение IsModified() метода `false` на момент реализации в производном классе. (Унаследовано от ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	Записывает содержимое этого элемента конфигурации в файл конфигурации. (Унаследовано от ServiceModelExtensionElement)
SerializeToXmlElement(XmlWriter, String)	Записывает внешние теги этого элемента конфигурации в файл конфигурации при реализации в производном классе. (Унаследовано от ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Задает свойству указанное значение. (Унаследовано от ConfigurationElement)
SetPropertyValueIfNotDefaultValue<T>(String, T)	Задает значение свойства для элемента конфигурации, если значение не является значением по умолчанию. (Унаследовано от ServiceModelConfigurationElement)
SetReadOnly()	IsReadOnly() Задает свойство для ConfigurationElement объекта и всех вложенных элементов. (Унаследовано от ConfigurationElement)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Изменяет объект для удаления всех значений ConfigurationElement , которые не должны быть сохранены. (Унаследовано от ConfigurationElement)

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

См. также раздел

<serviceDebug>

Обратная связь

Были ли сведения на этой странице полезными?