ServiceDebugElement Klasse

Definition

Namespace:: System.ServiceModel.Configuration

Assembly:: System.ServiceModel.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt ein Konfigurationselement dar, das Debug- und Hilfeinformationsfeatures für einen WCF-Dienst (Windows Communication Foundation) angibt. Diese Klasse kann nicht vererbt werden.

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

Vererbung: Object

ConfigurationElement

ServiceModelExtensionElement

BehaviorExtensionElement
ServiceDebugElement

Vererbung: Object

ConfigurationElement

ServiceModelConfigurationElement

ServiceModelExtensionElement

BehaviorExtensionElement
ServiceDebugElement

Beispiele

Das folgende Codebeispiel zeigt, wie Sie eine Konfigurationsdatei verwenden, um das HTML-Hilfeseitenfeature zu aktivieren und Ausnahmeinformationen innerhalb eines SOAP-Fehlers für Debuggingzwecke (zusätzlich zur Aktivierung der Metadatenunterstützung) an den Client zurückzugeben.

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

Hinweise

Wenn Sie die IncludeExceptionDetailInFaults Eigenschaft true programmgesteuert festlegen, können Sie den Fluss von verwalteten Ausnahmeinformationen für Debuggingzwecke an den Client sowie die Veröffentlichung von HTML-Informationsdateien für Benutzer aktivieren, die den Dienst in Webbrowsern durchsuchen.

Vorsicht

Das Zurückgeben von verwalteten Ausnahmeinformationen an Dienste kann ein Sicherheitsrisiko darstellen. Dies liegt daran, dass Ausnahmedetails Informationen zur internen Clientimplementierung verfügbar machen, die von nicht autorisierten Diensten verwendet werden können.

Die HttpHelpPageEnabled und HttpsHelpPageEnabled die Eigenschaften weisen den Dienst an, HTML-Hilfedateien zu veröffentlichen, wenn der Dienst mithilfe eines HTML-Browsers angezeigt wird.

HttpsHelpPageUrl Mit HttpHelpPageUrl den Eigenschaften wird der Speicherort der angezeigten HTML-Hilfeseite gesteuert.

Um eines der ServiceDebugElement Features mithilfe einer Konfigurationsdatei zu aktivieren oder zu deaktivieren, müssen Sie:

Fügen Sie dem <Dienstelement> für Ihren WCF-Dienst ein behaviorConfiguration Attribut hinzu. (Endpunktverhalten wird für <endpoint> Elemente konfiguriert; Dienstverhalten für <Dienstelemente> .)
Fügen Sie einen <Abschnitt "serviceBehaviors> " hinzu, oder erstellen Sie diesen einen <Verhaltenselement> mit dem Namen, der dem behaviorConfiguration Attributwert aus Schritt 1 entspricht. (Endpunktverhalten wird mithilfe eines <EndpointBehaviors-Elements> konfiguriert. Dienstverhalten wird mit einem <serviceBehaviors-Element> konfiguriert.
Fügen Sie dem <Verhaltenselement> aus Schritt 2 ein <"serviceDebug>"-Element hinzu, und aktivieren oder deaktivieren Sie die verschiedenen Eigenschaften, die für Ihr Szenario geeignet sind.

Ein bestimmtes Beispiel finden Sie im Abschnitt "Beispiel".

Konstruktoren

Name	Beschreibung
ServiceDebugElement()	Initialisiert eine neue Instanz der ServiceDebugElement-Klasse.

Eigenschaften

Name	Beschreibung
BehaviorType	Ruft den Typ dieses Verhaltenselements ab.
ConfigurationElementName	Ruft den Namen dieses Konfigurationselements ab. (Geerbt von ServiceModelExtensionElement)
CurrentConfiguration	Ruft einen Verweis auf die Instanz der obersten Ebene Configuration ab, die die Konfigurationshierarchie darstellt, zu der die aktuelle ConfigurationElement Instanz gehört. (Geerbt von ConfigurationElement)
ElementInformation	Ruft ein ElementInformation Objekt ab, das die nicht anpassbaren Informationen und Funktionen des ConfigurationElement Objekts enthält. (Geerbt von ConfigurationElement)
ElementProperty	Ruft das ConfigurationElementProperty Objekt ab, das das ConfigurationElement Objekt selbst darstellt. (Geerbt von ConfigurationElement)
EvaluationContext	Ruft das ContextInformation-Objekt für das ConfigurationElement-Objekt ab. (Geerbt von ConfigurationElement)
HasContext	Ruft einen Wert ab, der angibt, ob die CurrentConfiguration Eigenschaft ist `null`. (Geerbt von ConfigurationElement)
HttpHelpPageBinding	Dient zum Abrufen oder Festlegen eines Zeichenfolgenwerts, der die Bindung angibt, die verwendet werden soll, wenn HTTP für den Zugriff auf die Diensthilfeseite verwendet wird.
HttpHelpPageBindingConfiguration	Dient zum Abrufen oder Festlegen einer Zeichenfolge, die auf einen XML-Abschnitt verweist, der zusätzliche Konfigurationsinformationen für die in HttpHelpPageBinding.
HttpHelpPageEnabled	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob Windows Communication Foundation (WCF) eine HTML-Hilfeseite an der von der HttpHelpPageUrl Eigenschaft angegebenen Adresse veröffentlicht.
HttpHelpPageUrl	Ruft den Speicherort ab, an dem die HTML-Hilfedatei veröffentlicht wird, oder legt sie fest.
HttpsHelpPageBinding	Dient zum Abrufen oder Festlegen eines Zeichenfolgenwerts, der die Bindung angibt, die verwendet werden soll, wenn HTTPS für den Zugriff auf die Diensthilfeseite verwendet wird.
HttpsHelpPageBindingConfiguration	Dient zum Abrufen oder Festlegen einer Zeichenfolge, die auf einen XML-Abschnitt verweist, der zusätzliche Konfigurationsinformationen für die in HttpsHelpPageBinding.
HttpsHelpPageEnabled	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob Windows Communication Foundation (WCF) eine HTML-Hilfedatei über HTTPS an der durch die HttpsHelpPageUrl Eigenschaft angegebenen Adresse zurückgibt.
HttpsHelpPageUrl	Ruft den Speicherort ab, an dem eine HTML-Hilfedatei für den Abruf mithilfe von HTTPS veröffentlicht wird, oder legt den Speicherort fest.
IncludeExceptionDetailInFaults	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob verwaltete Ausnahmeinformationen in die Details der SOAP-Fehler einbezogen werden sollen, die für Debuggingzwecke an den Client zurückgegeben werden.
Item[ConfigurationProperty]	Dient zum Abrufen oder Festlegen einer Eigenschaft oder eines Attributs dieses Konfigurationselements. (Geerbt von ConfigurationElement)
Item[String]	Dient zum Abrufen oder Festlegen einer Eigenschaft, eines Attributs oder eines untergeordneten Elements dieses Konfigurationselements. (Geerbt von ConfigurationElement)
LockAllAttributesExcept	Ruft die Auflistung gesperrter Attribute ab. (Geerbt von ConfigurationElement)
LockAllElementsExcept	Ruft die Auflistung gesperrter Elemente ab. (Geerbt von ConfigurationElement)
LockAttributes	Ruft die Auflistung gesperrter Attribute ab. (Geerbt von ConfigurationElement)
LockElements	Ruft die Auflistung gesperrter Elemente ab. (Geerbt von ConfigurationElement)
LockItem	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Element gesperrt ist. (Geerbt von ConfigurationElement)
Properties	Ruft die Auflistung von Eigenschaften ab. (Geerbt von ConfigurationElement)

Methoden

Name	Beschreibung
CopyFrom(ServiceModelExtensionElement)	Kopiert den Inhalt des angegebenen Konfigurationselements in dieses Konfigurationselement.
CreateBehavior()	Erstellt eine Verhaltenserweiterung basierend auf den aktuellen Konfigurationseinstellungen. (Geerbt von BehaviorExtensionElement)
DeserializeElement(XmlReader, Boolean)	Liest XML aus der Konfigurationsdatei. (Geerbt von ConfigurationElement)
Equals(Object)	Vergleicht die aktuelle ConfigurationElement Instanz mit dem angegebenen Objekt. (Geerbt von ConfigurationElement)
GetHashCode()	Ruft einen eindeutigen Wert ab, der die aktuelle ConfigurationElement Instanz darstellt. (Geerbt von ConfigurationElement)
GetTransformedAssemblyString(String)	Gibt die transformierte Version des angegebenen Assemblynamens zurück. (Geerbt von ConfigurationElement)
GetTransformedTypeString(String)	Gibt die transformierte Version des angegebenen Typnamens zurück. (Geerbt von ConfigurationElement)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
Init()	Legt das ConfigurationElement Objekt auf seinen Anfangszustand fest. (Geerbt von ConfigurationElement)
InitializeDefault()	Wird verwendet, um einen Standardsatz von Werten für das ConfigurationElement Objekt zu initialisieren. (Geerbt von ConfigurationElement)
IsModified()	Ruft einen Wert ab, der angibt, ob dieses Konfigurationselement geändert wurde. (Geerbt von ServiceModelExtensionElement)
IsReadOnly()	Ruft einen Wert ab, der angibt, ob das ConfigurationElement Objekt schreibgeschützt ist. (Geerbt von ConfigurationElement)
ListErrors(IList)	Fügt der übergebenen Liste die Fehler der ungültigen Eigenschaft in diesem ConfigurationElement Objekt und in allen Unterelementen hinzu. (Geerbt von ConfigurationElement)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
OnDeserializeUnrecognizedAttribute(String, String)	Ruft einen Wert ab, der angibt, ob während der Deserialisierung ein unbekanntes Attribut gefunden wird. (Geerbt von ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Ruft einen Wert ab, der angibt, ob während der Deserialisierung ein unbekanntes Element auftritt. (Geerbt von ConfigurationElement)
OnRequiredPropertyNotFound(String)	Löst eine Ausnahme aus, wenn eine erforderliche Eigenschaft nicht gefunden wird. (Geerbt von ConfigurationElement)
PostDeserialize()	Wird nach der Deserialisierung aufgerufen. (Geerbt von ConfigurationElement)
PreSerialize(XmlWriter)	Wird vor der Serialisierung aufgerufen. (Geerbt von ConfigurationElement)
Reset(ConfigurationElement)	Setzt den internen Status dieses Konfigurationselementobjekts zurück, einschließlich der Sperren und der Eigenschaftenauflistungen. (Geerbt von ServiceModelExtensionElement)
ResetModified()	Setzt den Wert der IsModified() Methode zurück, wenn `false` sie in einer abgeleiteten Klasse implementiert wird. (Geerbt von ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	Schreibt den Inhalt dieses Konfigurationselements in die Konfigurationsdatei. (Geerbt von ServiceModelExtensionElement)
SerializeToXmlElement(XmlWriter, String)	Schreibt die äußeren Tags dieses Konfigurationselements in die Konfigurationsdatei, wenn sie in einer abgeleiteten Klasse implementiert wird. (Geerbt von ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Legt eine Eigenschaft auf den angegebenen Wert fest. (Geerbt von ConfigurationElement)
SetPropertyValueIfNotDefaultValue<T>(String, T)	Legt den Eigenschaftswert für das Konfigurationselement fest, wenn der Wert nicht der Standardwert ist. (Geerbt von ServiceModelConfigurationElement)
SetReadOnly()	Legt die IsReadOnly() Eigenschaft für das ConfigurationElement Objekt und alle Unterelemente fest. (Geerbt von ConfigurationElement)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Ändert das ConfigurationElement Objekt, um alle Werte zu entfernen, die nicht gespeichert werden sollen. (Geerbt von ConfigurationElement)

Gilt für:

Weitere Informationen

<serviceDebug>

Feedback

War diese Seite hilfreich?