Perilaku Debug Layanan

Sampel ServiceDebug menunjukkan bagaimana pengaturan perilaku debug layanan dapat dikonfigurasi. Sampel ini didasarkan pada panduan Memulai, yang mengimplementasikan ICalculator kontrak layanan. Sampel ini secara eksplisit menentukan perilaku debug layanan dalam file konfigurasi. Ini juga dapat dilakukan secara imperatif dalam kode.

Dalam sampel ini, klien adalah aplikasi konsol (.exe) dan layanan dihosting oleh Internet Information Services (IIS).

File Web.config untuk server menentukan perilaku debug layanan untuk mengaktifkan halaman bantuan dan penanganan pengecualian seperti yang ditunjukkan dalam sampel berikut.

<behaviors>
     <serviceBehaviors>
         <behavior name="CalculatorServiceBehavior">
         <!-- WARNING: Setting includeExceptionDetailInFaults = "True" could result in leaking secured server information to the client.-->
         <!-- Please set this to false when deploying -->
             <serviceDebug includeExceptionDetailInFaults="True" httpHelpPageEnabled="True"/>
         </behavior>
     </serviceBehaviors>
</behaviors>

<serviceDebug> adalah elemen konfigurasi yang memungkinkan perubahan properti perilaku debug layanan. Pengguna dapat mengubah perilaku ini untuk mencapai hal berikut:

• Ini memungkinkan layanan untuk mengembalikan pengecualian apa pun yang dilemparkan oleh kode aplikasi bahkan jika pengecualian tidak dinyatakan menggunakan FaultContractAttribute. Ini dilakukan dengan mengatur includeExceptionDetailInFaults ke true. Pengaturan ini berguna saat men-debug kasus di mana server melemparkan pengecualian tak terduga.

  Penting

  Tidak aman untuk mengaktifkan pengaturan ini di lingkungan produksi. Pengecualian server yang tidak terduga mungkin memiliki beberapa informasi yang tidak dimaksudkan untuk klien, jadi pengaturan includeExceptionDetailsInFaults ke true dapat mengakibatkan kebocoran informasi.

• <ServiceDebug> juga memungkinkan pengguna untuk mengaktifkan atau menonaktifkan halaman bantuan. Setiap layanan dapat secara opsional mengekspos halaman bantuan yang berisi informasi tentang layanan termasuk titik akhir untuk mendapatkan WSDL untuk layanan. Ini dapat diaktifkan dengan mengatur httpHelpPageEnabled ke true. Ini memungkinkan halaman bantuan dikembalikan ke permintaan GET ke alamat dasar layanan. Anda dapat mengubah alamat ini dengan mengatur atribut httpHelpPageUrllain . Anda dapat mengamankan ini dengan menggunakan HTTPS alih-alih HTTP. Ini dapat dilakukan dengan mengatur httpsHelpPageEnabled dan httpsHelpPageUrl.

Saat Anda menjalankan sampel, permintaan dan respons operasi ditampilkan di jendela konsol klien. Tiga operasi pertama (Tambahkan, Kurangi, dan Kalikan) harus berhasil. Operasi terakhir ("bagi") gagal dengan pembagian dengan pengecualian nol.

Untuk menyiapkan, mengompilasi, dan menjalankan sampel

1. Pastikan Anda telah melakukan Prosedur Penyiapan One-Time untuk Sampel Windows Communication Foundation.

2. Untuk membangun solusi edisi C# atau Visual Basic .NET, ikuti instruksi di Membangun Sampel Windows Communication Foundation.

3. Untuk menjalankan sampel dalam konfigurasi satu atau lintas komputer, ikuti instruksi di Menjalankan Sampel Windows Communication Foundation.