CallbackDebugBehavior.IncludeExceptionDetailInFaults Properti

Definisi

Ruang nama:

System.ServiceModel.Description

Rakitan:

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

Paket:

System.ServiceModel.Primitives v10.0.652802

Sumber:

CallbackDebugBehavior.cs

Mendapatkan atau menetapkan nilai yang mengontrol apakah objek panggilan balik klien mengembalikan informasi pengecualian terkelola dalam kesalahan SOAP kembali ke layanan.

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

Nilai Properti

Boolean

true jika WCF mengembalikan informasi pengecualian panggilan balik klien terkelola dalam kesalahan SOAP untuk tujuan penelusuran kesalahan layanan dalam komunikasi dupleks; jika tidak, false. Defaultnya adalah false.

Contoh

Contoh kode berikut menunjukkan file konfigurasi klien yang menginstruksikan WCF untuk mengembalikan informasi pengecualian terkelola dari objek panggilan balik klien dalam pesan SOAP.

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

Keterangan

Atur IncludeExceptionDetailInFaults properti ke true dari file konfigurasi aplikasi atau secara terprogram untuk mengaktifkan alur informasi pengecualian terkelola dalam objek panggilan balik klien kembali ke layanan untuk tujuan penelusuran kesalahan.

Perhatian

Mengembalikan informasi pengecualian terkelola ke layanan dapat menjadi risiko keamanan karena detail pengecualian mengekspos informasi tentang implementasi klien internal yang dapat digunakan oleh layanan yang tidak sah. Selain itu, meskipun properti CallbackDebugBehavior juga dapat diatur secara terprogram, mudah untuk lupa menonaktifkan IncludeExceptionDetailInFaults saat menerapkan.

Karena masalah keamanan yang terlibat, sangat disarankan agar:

• Anda menggunakan file konfigurasi aplikasi untuk mengatur nilai properti ke IncludeExceptionDetailInFaultstrue.

• Anda hanya melakukannya dalam skenario penelusuran kesalahan terkontrol.

Untuk informasi selengkapnya tentang masalah keamanan yang terkait dengan informasi pengecualian terkelola, lihat Menentukan dan Menangani Kesalahan dalam Kontrak dan Layanan.

Untuk mengaktifkan atau menonaktifkan fitur CallbackDebugBehavior menggunakan file konfigurasi

1. behaviorConfiguration Tambahkan atribut ke elemen titik> akhir klien< untuk aplikasi klien WCF Anda. Perilaku adalah CallbackDebugBehavior perilaku titik akhir. Perilaku titik akhir dikonfigurasi pada <endpoint> elemen; perilaku layanan dikonfigurasi pada <elemen layanan> .

2. Tambahkan atau buat <bagian endpointBehaviors> dan tambahkan <elemen perilaku> ke dalamnya dengan nama yang cocok behaviorConfiguration dengan nilai atribut dari langkah 1. Perilaku titik akhir ditambahkan untuk digunakan dalam elemen titik> akhir klien< menggunakan <elemen endpointBehaviors>.

3. <Tambahkan elemen callbackDebug> ke <elemen perilaku> dari langkah 2 dan aktifkan atau nonaktifkan berbagai properti yang sesuai dengan skenario Anda.

Untuk contoh tertentu, lihat bagian Contoh. Anda juga dapat mengatur nilai atribut ini dengan menggunakan <elemen callbackDebug> dalam file konfigurasi aplikasi klien.