ServiceDebugBehavior.HttpHelpPageEnabled Özellik

Tanım

Ad Alanı:

System.ServiceModel.Description

Bütünleştirilmiş Kod:

System.ServiceModel.dll

Windows Communication Foundation'ın (WCF) özelliği tarafından HttpHelpPageUrl denetlenen adreste bir HTML yardım sayfası yayımlayıp yayımlamayacağını denetleyan bir değer alır veya ayarlar.

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

public bool HttpHelpPageEnabled { get; set; }

member this.HttpHelpPageEnabled : bool with get, set

Public Property HttpHelpPageEnabled As Boolean

Özellik Değeri

Boolean

true WCF bir HTML yardım sayfası yayımlarsa; aksi takdirde , false. Varsayılan değer: true.

Örnekler

Aşağıdaki kod örneğinde, HTML yardım sayfası özelliğini etkinleştirmek için yapılandırma dosyasının nasıl kullanılacağı ve hata ayıklama amacıyla soap hatasının içindeki özel durum bilgilerinin istemciye nasıl döndürüleceği gösterilmektedir. Bu yapılandırma dosyası, özellikler için destek eklemeye ServiceDebugBehavior yönelik aşağıdaki temel adımları gösterir:

• ServiceDebugBehavior Tür bir System.ServiceModel.Description.IServiceBehavior uygulama olduğundan, <hizmet türünü temsil eden hizmet> öğesinin davranış yapılandırma tanımlayıcısı behaviorConfiguration="metadataAndDebug"vardır.

• Yine, tür bir System.ServiceModel.Description.IServiceBehavior uygulama olduğundan ServiceDebugBehaviorserviceBehaviors> bölümüne bir<davranış> öğesi< eklenir. name değeri olan davranış> öğesinin< özniteliği, hizmet> öğesinin özniteliğinin tanımlayıcısıdır<behaviorConfiguration. Bu durumda değeri metadataAndDebug.

• çeşitli öznitelikleri istenen yapılandırmaya ayarlanmış bir <serviceDebug> öğesi ekleyin. Bu durumda ve httpHelpPageEnabledincludeExceptionDetailInFaults öznitelik değerleri olarak trueayarlanır.

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

Açıklamalar

HttpHelpPageEnabled HTML tarayıcılarında görünen bir HTML yardım sayfasının yayınını devre dışı bırakmak için özelliğini false olarak ayarlayın.

HTML yardım sayfasının özelliği tarafından denetlenen konumda yayımlandığından HttpsHelpPageUrl emin olmak için, bu özelliği true olarak ayarlamanız ve ardından aşağıdaki koşullardan birinin de doğru olması gerekir:

• HttpsHelpPageUrl özelliği, HTTP protokol düzenini destekleyen mutlak bir adrestir.

• HIZMETIN HTTP protokol düzenini destekleyen bir temel adresi vardır.

ÖZELLIĞIne HttpsHelpPageUrl HTTP protokol düzenini desteklemeyen bir mutlak adres atanırsa bir özel durum oluşturulur, ancak önceki ölçütlerden hiçbirinin karşılanmadığı başka bir senaryo özel durum ve HTML yardım sayfasıyla sonuçlanmaz.