ServiceDebugBehavior Klas

Definitie

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

Overname

Object

ServiceDebugBehavior

Implementeringen

IServiceBehavior

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een configuratiebestand gebruikt om de html-helppaginafunctie in te schakelen en uitzonderingsinformatie in een SOAP-fout terug te sturen naar de client voor foutopsporing, naast het inschakelen van ondersteuning voor metagegevens. Dit configuratiebestand bevat de volgende basisstappen voor het toevoegen van ondersteuning voor de ServiceDebugBehavior functies:

• Omdat het ServiceDebugBehavior type een System.ServiceModel.Description.IServiceBehavior implementatie is, heeft het <service-element dat het servicetype> vertegenwoordigt een gedragsconfiguratie-id van behaviorConfiguration="metadataAndDebug".

• Omdat het ServiceDebugBehavior type een System.ServiceModel.Description.IServiceBehavior implementatie is, wordt een <gedragselement> toegevoegd aan een <serviceBehaviors-sectie> . Stel het name kenmerk van het <gedragselement> in waarvan de waarde de id is van het behaviorConfiguration kenmerk van het <service-element> . In dit geval is de waarde metadataAndDebug.

• Voeg een <serviceDebug-element> toe met de verschillende kenmerken die zijn ingesteld op de gewenste configuratie. In dit geval worden de httpHelpPageEnabled en includeExceptionDetailInFaults kenmerkwaarden ingesteld op 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>

Opmerkingen

Gebruik de ServiceDebugBehavior eigenschappen van een configuratiebestand of programmatisch om de stroom van beheerde uitzonderingsgegevens naar de client in te schakelen voor foutopsporingsdoeleinden, evenals de publicatie van HTML-informatiebestanden voor gebruikers die door de service bladeren in webbrowsers.

Stel de IncludeExceptionDetailInFaults eigenschap in om WCF opdracht te true geven om beheerde uitzonderingsinformatie in SOAP-fouten te retourneren aan clients voor foutopsporingsdoeleinden.

Vanwege de betrokken beveiligingsproblemen wordt ten zeere aangeraden:

• U gebruikt een toepassingsconfiguratiebestand om de waarde van de IncludeExceptionDetailInFaults eigenschap in te stellen op true.

• U doet dit alleen in beheerde foutopsporingsscenario's.

Zie Fouten opgeven en afhandelen in contracten en services voor meer informatie over de beveiligingsproblemen met betrekking tot beheerde uitzonderingsinformatie.

De HttpHelpPageEnabled en HttpsHelpPageEnabled eigenschappen geven de service opdracht om HTML Help-bestanden te publiceren wanneer de service wordt bekeken met behulp van een HTML-browser.

De HttpHelpPageUrl en HttpsHelpPageUrl eigenschappen bepalen de locatie van de HTML-Help-pagina die wordt weergegeven.

Een van de ServiceDebugBehavior functies in- of uitschakelen met behulp van een configuratiebestand:

1. Voeg een behaviorConfiguration kenmerk toe aan het <service-element> voor uw WCF-service. Eindpuntgedrag wordt geconfigureerd op <eindpuntelementen> ; servicegedrag op <service-elementen> .

2. Voeg een <serviceBehaviors-sectie> toe aan of maak er een <gedragselement> aan toe met de naam die overeenkomt met de behaviorConfiguration kenmerkwaarde uit stap 1. Eindpuntgedrag wordt geconfigureerd met behulp van een <endpointBehaviors-element> ; servicegedrag wordt geconfigureerd met behulp van een <serviceBehaviors-element> .

3. Voeg een <serviceDebug-element> toe aan het <gedragselement> uit stap 2 en schakel de verschillende eigenschappen in of uit die geschikt zijn voor uw scenario.

Zie de sectie Voorbeeld voor een specifiek voorbeeld.