ServiceDebugBehavior Třída

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 informační funkce nápovědy pro službu WCF (Windows Communication Foundation).

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 tyto funkce:

Vzhledem k tomu, že ServiceDebugBehavior typ je System.ServiceModel.Description.IServiceBehavior implementace, <element služby> , který představuje typ služby má identifikátor behaviorConfiguration="metadataAndDebug"konfigurace chování .
Vzhledem k tomu, že typ ServiceDebugBehavior je System.ServiceModel.Description.IServiceBehavior implementace <element chování> je 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 hodnota metadataAndDebug.
<Přidejte element ServiceDebug> s různými atributy nastavenými na požadovanou konfiguraci. V tomto případě jsou hodnoty atributu httpHelpPageEnabledincludeExceptionDetailInFaults nastaveny 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í z 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 tak, aby true WCF vrátil 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 neoprávnění klienti. Kromě toho, i když ServiceDebugBehavior je možné vlastnosti nastavit také programově, může být při nasazování snadné zapomenout zakázat IncludeExceptionDetailInFaults .

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

Konfigurační soubor aplikace slouží k nastavení hodnoty IncludeExceptionDetailInFaults vlastnosti na true.
Provedete to jenom ve scénářích řízeného ladění.

Další informace o problémech se zabezpečením souvisejících s informacemi o spravovaných výjimkách 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.

Vlastnosti HttpHelpPageUrl řídí HttpsHelpPageUrl umístění stránky nápovědy HTML, která je zobrazena.

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

behaviorConfiguration Přidejte atribut do elementu <služby> pro vaši službu WCF. Chování koncových bodů se konfiguruje u <prvků koncového bodu> , chování služby u <prvků služby> .
Přidejte nebo vytvořte <oddíl serviceBehaviors> a přidejte <do toho prvek chování> s názvem, který odpovídá hodnotě atributu behaviorConfiguration z kroku 1. Chování koncového bodu se konfiguruje pomocí elementu< endpointBehaviors. Chování služby se konfiguruje pomocí elementu serviceBehaviors>>.<
Přidejte do elementu <chování> element serviceDebug> 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

Name	Description
ServiceDebugBehavior()	Inicializuje novou instanci ServiceDebugBehavior třídy.

Vlastnosti

Name	Description
HttpHelpPageBinding	Získá nebo nastaví základní přístup k definici vazby.
HttpHelpPageEnabled	Získá nebo nastaví hodnotu, která řídí, 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í základní přístup 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é výjimce v podrobnostech chyb SOAP vrácených klientovi pro účely ladění.

Metody

Name	Description
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního 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í

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

Váš názor

Byla tato stránka užitečná?