ServiceDebugBehavior Klasse

Definition

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

Vererbung

Object

ServiceDebugBehavior

Implementiert

IServiceBehavior

Beispiele

Das folgende Codebeispiel zeigt, wie eine Konfigurationsdatei verwendet wird, um das HTML-Hilfeseitenfeature zu aktivieren und um Ausnahmeinformationen innerhalb eines SOAP-Fehlers für Debugzwecke an den Client zurückzugeben (zusätzlich zum Aktivieren der Metadatenunterstützung). Diese Konfigurationsdatei veranschaulicht die folgenden grundlegenden Schritte zum Hinzufügen der Unterstützung für die ServiceDebugBehavior-Features:

• Da der Typ eine System.ServiceModel.Description.IServiceBehavior Implementierung ist, weist das ServiceDebugBehavior <Dienstelement>, das den Diensttyp darstellt, einen Verhaltenskonfigurationsbezeichner von behaviorConfiguration="metadataAndDebug".

• Da der ServiceDebugBehavior Typ eine Implementierung ist, System.ServiceModel.Description.IServiceBehavior <wird ein Verhaltenelement> zu einem <DienstBehaviors-Abschnitt> hinzugefügt. Legen Sie das name Attribut des <Verhaltenselements> fest, dessen Wert der Bezeichner des behaviorConfiguration Attributs des< Dienstelements> ist. In diesem Fall handelt es sich um den Wert metadataAndDebug.

• Fügen Sie ein <ServiceDebug-Element> mit den verschiedenen Attributen hinzu, die auf die gewünschte Konfiguration festgelegt sind. In diesem Fall werden die httpHelpPageEnabled- und includeExceptionDetailInFaults-Attributwerte auf true festgelegt.

<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

Sie können den Fluss verwalteter Ausnahmeinformationen an den Client zu Debugzwecken sowie die Veröffentlichung von HTML-Informationsdateien für Benutzer, die den Dienst in Webbrowsern durchsuchen, mithilfe der ServiceDebugBehavior-Eigenschaften aus einer Konfigurationsdatei oder programmgesteuert aktivieren.

Legen Sie die IncludeExceptionDetailInFaults Eigenschaft true fest, um WCF anzuweisen, verwaltete Ausnahmeinformationen in SOAP-Fehlern an Clients für Debugzwecke zurückzugeben.

Wegen der damit verbundenen Sicherheitsprobleme wird Folgendes dringend empfohlen:

• Verwenden Sie eine Anwendungskonfigurationsdatei, um den Wert der IncludeExceptionDetailInFaults-Eigenschaft auf true festzulegen.

• Führen Sie diesen Vorgang nur in gesteuerten Debugszenarien aus.

Weitere Informationen zu den Sicherheitsproblemen im Zusammenhang mit verwalteten Ausnahmeinformationen finden Sie unter Angeben und Behandeln von Fehlern in Verträgen und Diensten.

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

Die HttpHelpPageUrl- und die HttpsHelpPageUrl-Eigenschaft steuern die Position der angezeigten HTML-Hilfeseite.

Gehen Sie wie folgt vor, um eines der ServiceDebugBehavior-Funktionen mit einer Konfigurationsdatei zu aktivieren oder zu deaktivieren:

1. Fügen Sie dem <Dienstelement für Ihren WCF-Dienst> ein behaviorConfiguration Attribut hinzu. Endpunktverhalten werden auf Elementen konfiguriert; Dienstverhalten auf <endpoint> <Dienstelementen> .

2. Fügen Sie einen Abschnitt "serviceBehaviors>" hinzu, und fügen Sie dem Namen ein< <Verhaltenelement> hinzu, das dem behaviorConfiguration Attributwert von Schritt 1 entspricht. Endpunktverhalten werden mithilfe eines EndpunktBehaviors-Elements konfiguriert; Dienstverhalten werden mithilfe eines <ServiceBehaviors-Elements> >konfiguriert.<

3. Fügen Sie dem Verhaltenelement> von Schritt 2 ein ServiceDebug-Element hinzu, und aktivieren oder deaktivieren Sie die verschiedenen Eigenschaften, die< für Ihr Szenario geeignet sind.><

Ein Beispiel hierfür finden Sie im Beispielabschnitt.

Konstruktoren

Eigenschaften

Methoden

Explizite Schnittstellenimplementierungen

Gilt für