ServiceDebugBehavior.IncludeExceptionDetailInFaults Vlastnost

Definice

Obor názvů:

System.ServiceModel.Description

Sestavení:

System.ServiceModel.dll

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

public:
 property bool IncludeExceptionDetailInFaults { bool get(); void set(bool value); };

public bool IncludeExceptionDetailInFaults { get; set; }

member this.IncludeExceptionDetailInFaults : bool with get, set

Public Property IncludeExceptionDetailInFaults As Boolean

Hodnota vlastnosti

Boolean

truepokud Windows Communication Foundation (WCF) vrátí informace o spravované výjimce v chybách SOAP pro účely ladění klienta; falsejinak . Výchozí formát je false.

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

• Opět, protože ServiceDebugBehavior typ 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 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

IncludeExceptionDetailInFaults Nastavte vlastnost taktrue, aby WCF vracela informace o spravovaných výjimkách klientovi v chybách SOAP, aby se usnadnilo 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 najdete v tématu Určení a zpracování chyb v kontraktech a službách.