ServiceDebugElement クラス

定義

public ref class ServiceDebugElement sealed : System::ServiceModel::Configuration::BehaviorExtensionElement

public sealed class ServiceDebugElement : System.ServiceModel.Configuration.BehaviorExtensionElement

type ServiceDebugElement = class
    inherit BehaviorExtensionElement

Public NotInheritable Class ServiceDebugElement
Inherits BehaviorExtensionElement

継承

Object

ConfigurationElement

ServiceModelExtensionElement

BehaviorExtensionElement

ServiceDebugElement

継承

Object

ConfigurationElement

ServiceModelConfigurationElement

ServiceModelExtensionElement

BehaviorExtensionElement

ServiceDebugElement

例

構成ファイルを使用して、HTML ヘルプ ページ機能を有効にし、メタデータのサポートを有効にすると共に、デバッグのために SOAP エラー内の例外情報をクライアントに返す方法を次のコード例に示します。

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

注釈

プログラムで IncludeExceptionDetailInFaults プロパティを true に設定すると、デバッグ目的でクライアントへのマネージド例外情報のフローを有効にし、Web ブラウザーでサービスを閲覧するユーザー向けに HTML 情報ファイルを公開できます。

HttpHelpPageEnabled プロパティおよび HttpsHelpPageEnabled プロパティにより、サービスが HTML ブラウザーを使用して表示されるときに HTML ヘルプ ファイルを公開できます。

HttpHelpPageUrl プロパティおよび HttpsHelpPageUrl プロパティは、表示される HTML ヘルプ ページの位置を制御します。

構成ファイルを使用していずれかの ServiceDebugElement 機能を有効または無効にするには、以下を行う必要があります。

1. WCF サービスのbehaviorConfigurationサービス>要素に< 属性を追加します。 (エンドポイントの動作は要素に対して<endpoint>構成され、サービス要素ではサービス>動作が<構成されます)。

2. serviceBehaviors> セクションを<追加<または作成し、手順 1 の属性値と一致する名前の behavior> 要素をbehaviorConfiguration追加します。 (エンドポイントの動作は endpointBehaviors> 要素を<使用して構成されます。サービス動作は serviceBehaviors> 要素を<使用して構成されます。

3. 手順 2 の behavior> 要素に serviceDebug 要素を<追加し、シナリオに適したさまざまなプロパティを有効または無効にします。><

個々の例については、「使用例」のセクションを参照してください。

コンストラクター

プロパティ

メソッド

適用対象

こちらもご覧ください

• <serviceDebug>