ServiceDebugBehavior Třída

Reference

Definice

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

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

Umožňuje ladění a funkce informací nápovědy pro službu Windows Communication Foundation (WCF).

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

Dědičnost: Object
ServiceDebugBehavior

Implementuje: IServiceBehavior

Příklady

Následující příklad kódu ukazuje, jak pomocí konfiguračního souboru povolit funkci stránky 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. Tento konfigurační soubor ukazuje následující základní kroky pro přidání podpory pro ServiceDebugBehavior funkce:

Vzhledem k tomu, že typ ServiceDebugBehavior je System.ServiceModel.Description.IServiceBehavior implementace, <element služby, který představuje typ služby>, má identifikátor konfigurace chování .behaviorConfiguration="metadataAndDebug"
Vzhledem k tomu, že typ ServiceDebugBehavior je System.ServiceModel.Description.IServiceBehavior implementace <element chování> přidán do oddílu <serviceBehaviors> . name Nastavte atribut <prvku chování>, jehož hodnota je identifikátor behaviorConfiguration atributu <prvku služby>. V tomto případě je metadataAndDebughodnota .
<Přidejte element ServiceDebug> s různými atributy nastavenými na požadovanou konfiguraci. V tomto případě jsou hodnoty a includeExceptionDetailInFaults atributy nastaveny httpHelpPageEnabled na 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>

Poznámky

ServiceDebugBehavior Pomocí vlastností konfiguračního souboru nebo programově povolte 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.

IncludeExceptionDetailInFaults Nastavte vlastnost taktrue, aby WCF vracela informace o spravovaných výjimkách v chybách SOAP klientům pro účely ladění.

Upozornění

Vrácení informací o spravovaných výjimce klientům může být bezpečnostní riziko, protože podrobnosti o výjimce zpřístupňují informace o interní implementaci služby, kterou můžou používat neautorizovanými klienty. Kromě toho, i když je ServiceDebugBehavior možné vlastnosti nastavit programově, může být snadné zapomenout při nasazování zakázat IncludeExceptionDetailInFaults .

Vzhledem k problémům se zabezpečením se důrazně doporučuje:

Konfigurační soubor aplikace slouží k nastavení hodnoty IncludeExceptionDetailInFaults vlastnosti na true.
Uděláte to jenom v kontrolovaných scénářích ladění.

Další informace o problémech zabezpečení souvisejících se spravovanými informacemi o výjimce najdete v tématu Určení a zpracování chyb v kontraktech a službách.

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

Povolení nebo zakázání některé z ServiceDebugBehavior funkcí pomocí konfiguračního souboru:

behaviorConfiguration Přidejte atribut do elementu <služby> pro vaši službu WCF. Chování koncových bodů se konfiguruje u <endpoint> prvků, chování služby 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

ServiceDebugBehavior()

Inicializuje novou instanci ServiceDebugBehavior třídy.

Vlastnosti

HttpHelpPageBinding	Získá nebo nastaví přístup vysoké úrovně k definici vazby.
HttpHelpPageEnabled	Získá nebo nastaví hodnotu, která určuje, zda Windows Communication Foundation (WCF) publikuje stránku nápovědy HTML na adrese řízené 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í přístup vysoké úrovně k definici vazby.
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 řízené HttpsHelpPageUrl vlastností.
HttpsHelpPageUrl	Získá nebo nastaví umístění, ve kterém je soubor 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í.

Metody

Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Type Získá aktuální instanci. (Zděděno od Object)
MemberwiseClone()	Vytvoří použádnou kopii aktuálního souboru Object. (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Explicitní implementace rozhraní

IServiceBehavior.AddBindingParameters(ServiceDescription, ServiceHostBase, Collection<ServiceEndpoint>, BindingParameterCollection)	Implementuje metodu AddBindingParameters(ServiceDescription, ServiceHostBase, Collection<ServiceEndpoint>, BindingParameterCollection) pro podporu chování.
IServiceBehavior.ApplyDispatchBehavior(ServiceDescription, ServiceHostBase)	Implementuje metodu ApplyDispatchBehavior(ServiceDescription, ServiceHostBase) pro podporu chování.
IServiceBehavior.Validate(ServiceDescription, ServiceHostBase)	Implementuje metodu Validate(ServiceDescription, ServiceHostBase) pro podporu chování.

Platí pro

Share via