CallbackDebugBehavior.IncludeExceptionDetailInFaults Özellik

Başvuru

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.

İstemci geri çağırma nesnelerinin SOAP hatalarındaki yönetilen özel durum bilgilerini hizmete geri döndürip döndürmediğini denetleyebilen bir değer alır veya ayarlar.

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

Özellik Değeri

Boolean

true WCF, çift yönlü iletişimde hizmet hata ayıklama amacıyla SOAP hatalarında yönetilen istemci geri çağırma özel durum bilgilerini döndürürse; aksi takdirde , false. Varsayılan değer: false.

Örnekler

Aşağıdaki kod örneği, WCF'ye SOAP iletilerindeki bir istemci geri çağırma nesnesinden yönetilen özel durum bilgilerini döndürmesini emreden bir istemci yapılandırma dosyasını gösterir.

  <client>
      <endpoint 
        address="http://localhost:8080/DuplexHello" 
        binding="wsDualHttpBinding"
        bindingConfiguration="WSDualHttpBinding_SampleDuplexHello"
        contract="SampleDuplexHello" 
        name="WSDualHttpBinding_SampleDuplexHello"
        behaviorConfiguration="enableCallbackDebug">
      </endpoint>
  </client>
<behaviors>
  <endpointBehaviors>
    <behavior name="enableCallbackDebug">
      <callbackDebug includeExceptionDetailInFaults="true"/>
    </behavior>
  </endpointBehaviors>
</behaviors>

Açıklamalar

IncludeExceptionDetailInFaults true Hata ayıklama amacıyla bir istemci geri çağırma nesnesinde yönetilen özel durum bilgilerinin akışını hizmete geri döndürmek için özelliğini bir uygulama yapılandırma dosyasından veya program aracılığıyla olarak ayarlayın.

Dikkat

Özel durum ayrıntıları yetkisiz hizmetler tarafından kullanılabilecek iç istemci uygulamasıyla ilgili bilgileri kullanıma sunduğundan, yönetilen özel durum bilgilerinin hizmetlere döndürüleceği bir güvenlik riski oluşturabilir. Ayrıca, özellikler program aracılığıyla da ayarlansa CallbackDebugBehavior da, dağıtım sırasında devre dışı bırakmak IncludeExceptionDetailInFaults kolay olabilir.

İlgili güvenlik sorunları nedeniyle şunların kullanılması kesinlikle önerilir:

Özelliğinin IncludeExceptionDetailInFaults truedeğ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.

Yapılandırma dosyası kullanarak CallbackDebugBehavior özelliğini etkinleştirmek veya devre dışı bırakmak için

WCF istemci uygulamanız için istemci <endpoint> öğesine bir behaviorConfiguration öznitelik ekleyin. Davranış CallbackDebugBehavior bir uç nokta davranışıdır. Uç nokta davranışları öğelerde <endpoint> yapılandırılır; hizmet davranışları hizmet> öğelerinde< yapılandırılır.
endpointBehaviors> bölümüne ekleyin veya oluşturun< ve 1. adımdaki öznitelik değeriyle eşleşen behaviorConfiguration adla buna bir <davranış> öğesi ekleyin. Uç nokta davranışları, endpointBehaviors> öğesi kullanılarak bir< istemci <endpoint> öğesinde kullanılmak üzere eklenir.
1. adımdaki davranış> öğesine bir callbackDebug öğ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. Bu özniteliğin değerlerini, istemci uygulaması yapılandırma dosyasında callbackDebug<> öğesini kullanarak da ayarlayabilirsiniz.

Şunlara uygulanır

Aracılığıyla paylaş