ServiceDebugBehavior Sınıf

Tanım

Ad Alanı:: System.ServiceModel.Description

Bütünleştirilmiş Kod:: System.ServiceModel.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Windows Communication Foundation (WCF) hizmeti için hata ayıklama ve yardım bilgileri özelliklerini etkinleştirir.

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

Devralma: Object
ServiceDebugBehavior

Uygulamalar: IServiceBehavior

Örnekler

Aşağıdaki kod örneği, HTML yardım sayfası özelliğini etkinleştirmek için yapılandırma dosyasının nasıl kullanılacağını ve meta veri desteğini etkinleştirmenin yanı sıra hata ayıklama amacıyla bir SOAP hatasının içindeki özel durum bilgilerini istemciye geri döndürmeyi gösterir. 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ı vardırbehaviorConfiguration="metadataAndDebug".
ServiceDebugBehavior Tür bir System.ServiceModel.Description.IServiceBehavior uygulama olduğundan serviceBehaviors> bölümüne bir<davranış> öğesi< eklenir. name değeri, hizmet> öğesinin özniteliğinin tanımlayıcısı olan behavior öğesinin özniteliğini<>ayarlayın.<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

ServiceDebugBehavior Web tarayıcılarında hizmete göz atan kullanıcılar için HTML bilgi dosyalarının yayımlanmasının yanı sıra hata ayıklama amacıyla istemciye yönetilen özel durum bilgilerinin akışını etkinleştirmek için bir yapılandırma dosyasından veya program aracılığıyla özelliklerini kullanın.

IncludeExceptionDetailInFaults WCF'ye soap hatalarındaki yönetilen özel durum bilgilerini hata ayıklama amacıyla istemcilere döndürmesini bildirmek için özelliğini true olarak ayarlayın.

Dikkat

Özel durum ayrıntıları yetkisiz istemciler tarafından kullanılabilecek iç hizmet uygulaması hakkındaki bilgileri kullanıma sunduğundan, yönetilen özel durum bilgilerinin istemcilere döndürülmesi güvenlik riski oluşturabilir. Ayrıca, ServiceDebugBehavior özellikleri program aracılığıyla da ayarlanabilse de, IncludeExceptionDetailInFaults devre dışı bırakmayı dağıtım sırasında unutmak kolay olabilir.

İlgili güvenlik sorunları nedeniyle aşağıdakiler kesinlikle önerilir:

Özelliğinin IncludeExceptionDetailInFaultstruedeğerini olarak ayarlamak için bir uygulama yapılandırma dosyası kullanırsınız.
Bunu yalnızca denetimli hata ayıklama senaryolarında yaparsınız.

Yönetilen özel durum bilgileriyle ilgili güvenlik sorunları hakkında daha fazla bilgi için bkz. Sözleşmelerde ve Hizmetlerde Hataları Belirtme ve İşleme.

HttpHelpPageEnabled ve HttpsHelpPageEnabled özellikleri, hizmet bir HTML tarayıcısı kullanılarak görüntülendiğinde hizmete HTML yardım dosyalarını yayımlamasını emreder.

ve HttpsHelpPageUrl özellikleri, HttpHelpPageUrl görüntülenen HTML yardım sayfasının konumunu denetler.

Yapılandırma dosyası kullanarak özelliklerden ServiceDebugBehavior birini etkinleştirmek veya devre dışı bırakmak için:

WCF hizmetinizin hizmet> öğesine bir öznitelik< ekleyin.behaviorConfiguration Uç nokta davranışları uç nokta> öğelerinde< yapılandırılır; hizmet öğelerindeki <hizmet> davranışları.
serviceBehaviors> bölümüne ekleyin veya bu< bölüme 1. adımdaki öznitelik değeriyle eşleşen behaviorConfiguration adla bir <davranış> öğesi ekleyin. Uç nokta davranışları endpointBehaviors<> öğesi kullanılarak yapılandırılır; hizmet davranışları bir <serviceBehaviors> öğesi kullanılarak yapılandırılır.
2. adımdaki davranış> öğesine bir serviceDebug öğesi< ekleyin ve senaryonuza uygun çeşitli özellikleri etkinleştirin veya devre dışı bırakın.><

Belirli bir örnek için Örnek bölümüne bakın.

Oluşturucular

Name	Description
ServiceDebugBehavior()	ServiceDebugBehavior sınıfının yeni bir örneğini başlatır.

Özellikler

Name	Description
HttpHelpPageBinding	Bağlamanın tanımına üst düzey erişimi alır veya ayarlar.
HttpHelpPageEnabled	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.
HttpHelpPageUrl	HTML yardım dosyasının yayımlandığı konumu alır veya ayarlar.
HttpsHelpPageBinding	Bağlamanın tanımına üst düzey erişimi alır veya ayarlar.
HttpsHelpPageEnabled	Windows Communication Foundation'ın (WCF) özelliği tarafından HttpsHelpPageUrl denetlenen adreste HTTPS üzerinden bir HTML yardım dosyası döndürdüğünü belirten bir değer alır veya ayarlar.
HttpsHelpPageUrl	BIR HTML dosyasının HTTPS kullanılarak alınması için yayımlandığı konumu alır veya ayarlar.
IncludeExceptionDetailInFaults	Hata ayıklama amacıyla istemciye döndürülen SOAP hatalarının ayrıntılarına yönetilen özel durum bilgilerinin eklenip eklenmeyeceğini belirten bir değer alır veya ayarlar.

Yöntemler

Name	Description
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)

Belirtik Arabirim Kullanımları

Name	Description
IServiceBehavior.AddBindingParameters(ServiceDescription, ServiceHostBase, Collection<ServiceEndpoint>, BindingParameterCollection)	AddBindingParameters(ServiceDescription, ServiceHostBase, Collection<ServiceEndpoint>, BindingParameterCollection) Davranışı desteklemek için yöntemini uygular.
IServiceBehavior.ApplyDispatchBehavior(ServiceDescription, ServiceHostBase)	ApplyDispatchBehavior(ServiceDescription, ServiceHostBase) Davranışı desteklemek için yöntemini uygular.
IServiceBehavior.Validate(ServiceDescription, ServiceHostBase)	Validate(ServiceDescription, ServiceHostBase) Davranışı desteklemek için yöntemini uygular.

Şunlara uygulanır

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?