ServiceDebugElement Třída

Reference

Definice

Obor názvů:: System.ServiceModel.Configuration

Sestavení:: System.ServiceModel.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Představuje konfigurační prvek, který určuje funkce ladění a nápovědy pro službu Windows Communication Foundation (WCF). Tuto třídu nelze dědit.

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

Dědičnost: Object

ConfigurationElement

ServiceModelExtensionElement

BehaviorExtensionElement
ServiceDebugElement

Dědičnost: Object

ConfigurationElement

ServiceModelConfigurationElement

ServiceModelExtensionElement

BehaviorExtensionElement
ServiceDebugElement

Příklady

Následující příklad kódu ukazuje, jak pomocí konfiguračního souboru povolit funkci nápovědy HTML a vrátit informace o výjimce uvnitř chyby SOAP zpět klientovi pro účely ladění (kromě povolení podpory metadat).

<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>

Poznámky

Pokud vlastnost true nastavíte IncludeExceptionDetailInFaults programově, můžete povolit tok informací o spravovaných výjimkách klientovi pro účely ladění a také publikování informačních souborů HTML pro uživatele, kteří procházejí službu ve webových prohlížečích.

Upozornění

Vrácení informací o spravovaných výjimce do služeb může být bezpečnostní riziko. Důvodem je to, že podrobnosti o výjimce zpřístupňují informace o interní implementaci klienta, která by mohla být používána neoprávněnými službami.

Služba HttpHelpPageEnabled a HttpsHelpPageEnabled vlastnosti instruují, aby při zobrazení služby pomocí prohlížeče HTML publikovala soubory nápovědy HTML.

HttpsHelpPageUrl Vlastnosti HttpHelpPageUrl určují umístění stránky nápovědy HTML, která se zobrazí.

Pokud chcete povolit nebo zakázat některou z ServiceDebugElement funkcí pomocí konfiguračního souboru, musíte:

behaviorConfiguration Přidejte atribut do elementu <služby> pro vaši službu WCF. (Chování koncového bodu se konfiguruje u <endpoint> prvků, chování služeb u <prvků služby> .)
Přidejte do oddílu <ServiceBehaviors> nebo vytvořte <element chování> s názvem, který odpovídá hodnotě atributu behaviorConfiguration z kroku 1. (Chování koncových bodů se konfiguruje pomocí elementu< endpointBehaviors>; chování služby se konfiguruje pomocí elementu <serviceBehaviors>.
<Přidejte element ServiceDebug> do elementu <chování> z kroku 2 a povolte nebo zakažte různé vlastnosti vhodné pro váš scénář.

Konkrétní příklad najdete v části Příklad.

Konstruktory

ServiceDebugElement()

Inicializuje novou instanci ServiceDebugElement třídy.

Vlastnosti

BehaviorType	Získá typ tohoto prvku chování.
ConfigurationElementName	Získá název tohoto elementu konfigurace. (Zděděno od ServiceModelExtensionElement)
CurrentConfiguration	Získá odkaz na instanci nejvyšší úrovně Configuration , která představuje hierarchii konfigurace, do které aktuální ConfigurationElement instance patří. (Zděděno od ConfigurationElement)
ElementInformation	ElementInformation Získá objekt, který obsahuje neuzpůsobitelné informace a funkce objektuConfigurationElement. (Zděděno od ConfigurationElement)
ElementProperty	ConfigurationElementProperty Získá objekt, který představuje ConfigurationElement samotný objekt. (Zděděno od ConfigurationElement)
EvaluationContext	ContextInformation Získá objekt objektuConfigurationElement. (Zděděno od ConfigurationElement)
HasContext	Získá hodnotu, která označuje, zda CurrentConfiguration je `null`vlastnost . (Zděděno od ConfigurationElement)
HttpHelpPageBinding	Získá nebo nastaví řetězcovou hodnotu, která určuje vazbu, která se má použít při použití HTTP pro přístup ke stránce nápovědy služby.
HttpHelpPageBindingConfiguration	Získá nebo nastaví řetězec odkazující na oddíl XML definující další konfigurační informace pro vazbu zadanou v HttpHelpPageBinding.
HttpHelpPageEnabled	Získá nebo nastaví hodnotu, která označuje, zda Windows Communication Foundation (WCF) publikuje stránku nápovědy HTML na adrese zadané HttpHelpPageUrl vlastností.
HttpHelpPageUrl	Získá nebo nastaví umístění, ve kterém je publikován soubor nápovědy HTML.
HttpsHelpPageBinding	Získá nebo nastaví řetězcovou hodnotu, která určuje vazbu, která se má použít při použití HTTPS pro přístup ke stránce nápovědy služby.
HttpsHelpPageBindingConfiguration	Získá nebo nastaví řetězec odkazující na oddíl XML definující další konfigurační informace pro vazbu zadanou v HttpsHelpPageBinding.
HttpsHelpPageEnabled	Získá nebo nastaví hodnotu, která určuje, zda Windows Communication Foundation (WCF) vrátí soubor nápovědy HTML přes HTTPS na adrese zadané HttpsHelpPageUrl vlastností.
HttpsHelpPageUrl	Získá nebo nastaví umístění, ve kterém je soubor nápovědy HTML publikován pro načtení pomocí HTTPS.
IncludeExceptionDetailInFaults	Získá nebo nastaví hodnotu, která určuje, zda zahrnout informace o spravovaných výjimkách v podrobnostech chyb SOAP vrácených klientovi pro účely ladění.
Item[ConfigurationProperty]	Získá nebo nastaví vlastnost nebo atribut tohoto konfiguračního prvku. (Zděděno od ConfigurationElement)
Item[String]	Získá nebo nastaví vlastnost, atribut nebo podřízený prvek tohoto konfiguračního prvku. (Zděděno od ConfigurationElement)
LockAllAttributesExcept	Získá kolekci uzamčených atributů. (Zděděno od ConfigurationElement)
LockAllElementsExcept	Získá kolekci uzamčených prvků. (Zděděno od ConfigurationElement)
LockAttributes	Získá kolekci uzamčených atributů. (Zděděno od ConfigurationElement)
LockElements	Získá kolekci uzamčených prvků. (Zděděno od ConfigurationElement)
LockItem	Získá nebo nastaví hodnotu určující, zda je prvek uzamčen. (Zděděno od ConfigurationElement)
Properties	Získá kolekci vlastností. (Zděděno od ConfigurationElement)

Metody

CopyFrom(ServiceModelExtensionElement)	Zkopíruje obsah zadaného konfiguračního prvku do tohoto konfiguračního prvku.
CreateBehavior()	Vytvoří rozšíření chování na základě aktuálního nastavení konfigurace. (Zděděno od BehaviorExtensionElement)
DeserializeElement(XmlReader, Boolean)	Načte XML z konfiguračního souboru. (Zděděno od ConfigurationElement)
Equals(Object)	Porovná aktuální ConfigurationElement instanci se zadaným objektem. (Zděděno od ConfigurationElement)
GetHashCode()	Získá jedinečnou hodnotu představující aktuální ConfigurationElement instanci. (Zděděno od ConfigurationElement)
GetTransformedAssemblyString(String)	Vrátí transformovanou verzi zadaného názvu sestavení. (Zděděno od ConfigurationElement)
GetTransformedTypeString(String)	Vrátí transformovanou verzi zadaného názvu typu. (Zděděno od ConfigurationElement)
GetType()	Type Získá aktuální instanci. (Zděděno od Object)
Init()	ConfigurationElement Nastaví objekt na počáteční stav. (Zděděno od ConfigurationElement)
InitializeDefault()	Slouží k inicializaci výchozí sady hodnot objektu ConfigurationElement . (Zděděno od ConfigurationElement)
IsModified()	Získá hodnotu, která určuje, zda byl tento element konfigurace změněn. (Zděděno od ServiceModelExtensionElement)
IsReadOnly()	Získá hodnotu určující, zda ConfigurationElement objekt je jen pro čtení. (Zděděno od ConfigurationElement)
ListErrors(IList)	Přidá chyby neplatné vlastnosti v tomto ConfigurationElement objektu a ve všech dílčích počtech do předaného seznamu. (Zděděno od ConfigurationElement)
MemberwiseClone()	Vytvoří použádnou kopii aktuálního souboru Object. (Zděděno od Object)
OnDeserializeUnrecognizedAttribute(String, String)	Získá hodnotu označující, zda je zjištěn neznámý atribut během deserializace. (Zděděno od ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Získá hodnotu označující, zda je při deserializaci zjištěn neznámý prvek. (Zděděno od ConfigurationElement)
OnRequiredPropertyNotFound(String)	Vyvolá výjimku, když se nenajde požadovaná vlastnost. (Zděděno od ConfigurationElement)
PostDeserialize()	Volá se po deserializaci. (Zděděno od ConfigurationElement)
PreSerialize(XmlWriter)	Volá se před serializací. (Zděděno od ConfigurationElement)
Reset(ConfigurationElement)	Obnoví vnitřní stav tohoto objektu elementu konfigurace, včetně zámků a kolekcí vlastností. (Zděděno od ServiceModelExtensionElement)
ResetModified()	Obnoví hodnotu IsModified() metody na `false` při implementaci v odvozené třídě. (Zděděno od ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	Zapíše obsah tohoto konfiguračního elementu do konfiguračního souboru. (Zděděno od ServiceModelExtensionElement)
SerializeToXmlElement(XmlWriter, String)	Zapíše vnější značky tohoto konfiguračního prvku do konfiguračního souboru při implementaci v odvozené třídě. (Zděděno od ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Nastaví vlastnost na zadanou hodnotu. (Zděděno od ConfigurationElement)
SetPropertyValueIfNotDefaultValue<T>(String, T)	Nastaví hodnotu vlastnosti elementu konfigurace, pokud hodnota není výchozí hodnotou. (Zděděno od ServiceModelConfigurationElement)
SetReadOnly()	IsReadOnly() Nastaví vlastnost pro ConfigurationElement objekt a všechny dílčí prvky. (Zděděno od ConfigurationElement)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Upraví objekt tak, ConfigurationElement aby odebral všechny hodnoty, které by neměly být uloženy. (Zděděno od ConfigurationElement)

Platí pro

Viz také

<serviceDebug>

Sdílet prostřednictvím