CallbackDebugBehavior.IncludeExceptionDetailInFaults Özellik

Tanım

Ad Alanı:

System.ServiceModel.Description

Bütünleştirilmiş Kodlar:

System.ServiceModel.dll, System.ServiceModel.Primitives.dll

Paket:

System.ServiceModel.Primitives v10.0.652802

Kaynak:

CallbackDebugBehavior.cs

İstemci geri çağırma nesnelerinin SOAP hatalarında 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 belirten bir istemci yapılandırma dosyası 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 Hata ayıklama amacıyla istemci geri çağırma nesnesindeki yönetilen özel durum bilgilerinin akışını hizmete geri döndürmek için özelliğini true 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ı hakkındaki bilgileri kullanıma sunduğundan, yönetilen özel durum bilgilerinin hizmetlere döndürüleceği bir güvenlik riski oluşturabilir. Ayrıca, CallbackDebugBehavior ö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.

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

1. WCF istemci uygulamanız için istemci <uç noktası> öğ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.

2. 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 istemci<<uç noktası> öğesinde kullanılmak üzere eklenir.

3. 2. 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.