ServiceDebugBehavior Kelas

Definisi

Ruang nama:: System.ServiceModel.Description

Rakitan:: System.ServiceModel.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mengaktifkan fitur informasi penelusuran kesalahan dan bantuan untuk layanan Windows Communication Foundation (WCF).

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

Warisan: Object
ServiceDebugBehavior

Penerapan: IServiceBehavior

Contoh

Contoh kode berikut menunjukkan cara menggunakan file konfigurasi untuk mengaktifkan fitur halaman bantuan HTML dan mengembalikan informasi pengecualian di dalam kesalahan SOAP kembali ke klien untuk tujuan penelusuran kesalahan, selain mengaktifkan dukungan metadata. File konfigurasi ini memperlihatkan langkah-langkah dasar berikut untuk menambahkan dukungan untuk fitur:ServiceDebugBehavior

Karena jenisnya ServiceDebugBehavior adalah System.ServiceModel.Description.IServiceBehavior implementasi, <elemen layanan> yang mewakili jenis layanan memiliki pengidentifikasi behaviorConfiguration="metadataAndDebug"konfigurasi perilaku .
Karena jenisnya ServiceDebugBehavior adalah System.ServiceModel.Description.IServiceBehavior implementasi <, elemen perilaku> ditambahkan ke <bagian serviceBehaviors> . Atur name atribut <elemen perilaku> yang nilainya adalah pengidentifikasi behaviorConfiguration atribut <elemen layanan> . Dalam hal ini, nilainya metadataAndDebug.
<Tambahkan elemen serviceDebug> dengan berbagai atribut yang diatur ke konfigurasi yang diinginkan. Dalam hal ini, httpHelpPageEnabled nilai atribut dan includeExceptionDetailInFaults diatur ke true.

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

Keterangan

ServiceDebugBehavior Gunakan properti dari file konfigurasi atau secara terprogram untuk mengaktifkan alur informasi pengecualian terkelola ke klien untuk tujuan penelusuran kesalahan serta publikasi file informasi HTML untuk pengguna yang menelusuri layanan di browser Web.

Atur IncludeExceptionDetailInFaults properti ke true untuk menginstruksikan WCF untuk mengembalikan informasi pengecualian terkelola dalam kesalahan SOAP kepada klien untuk tujuan penelusuran kesalahan.

Perhatian

Mengembalikan informasi pengecualian terkelola kepada klien dapat menjadi risiko keamanan karena detail pengecualian mengekspos informasi tentang implementasi layanan internal yang dapat digunakan oleh klien yang tidak sah. Selain itu, meskipun properti ServiceDebugBehavior 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.

Properti HttpHelpPageEnabled dan HttpsHelpPageEnabled menginstruksikan layanan untuk menerbitkan file bantuan HTML saat layanan dilihat menggunakan browser HTML.

Properti HttpHelpPageUrl dan HttpsHelpPageUrl mengontrol lokasi halaman bantuan HTML yang ditampilkan.

Untuk mengaktifkan atau menonaktifkan salah ServiceDebugBehavior satu fitur menggunakan file konfigurasi:

behaviorConfiguration Tambahkan atribut ke <elemen layanan> untuk layanan WCF Anda. Perilaku titik akhir dikonfigurasi pada <elemen titik> akhir; perilaku layanan pada <elemen layanan>.
Tambahkan atau buat <bagian serviceBehaviors> dan tambahkan <elemen perilaku> ke dalamnya dengan nama yang cocok behaviorConfiguration dengan nilai atribut dari langkah 1. Perilaku titik akhir dikonfigurasi menggunakan <elemen endpointBehaviors> ; perilaku layanan dikonfigurasi menggunakan <elemen serviceBehaviors> .
<Tambahkan elemen serviceDebug> ke <elemen perilaku> dari langkah 2 dan aktifkan atau nonaktifkan berbagai properti yang sesuai dengan skenario Anda.

Untuk contoh tertentu, lihat bagian Contoh.

Konstruktor

Nama	Deskripsi
ServiceDebugBehavior()	Menginisialisasi instans baru dari kelas ServiceDebugBehavior.

Properti

Nama	Deskripsi
HttpHelpPageBinding	Mendapatkan atau mengatur akses tingkat tinggi ke definisi pengikatan.
HttpHelpPageEnabled	Mendapatkan atau menetapkan nilai yang mengontrol apakah Windows Communication Foundation (WCF) menerbitkan halaman bantuan HTML di alamat yang dikontrol oleh HttpHelpPageUrl properti .
HttpHelpPageUrl	Mendapatkan atau mengatur lokasi tempat file bantuan HTML diterbitkan.
HttpsHelpPageBinding	Mendapatkan atau mengatur akses tingkat tinggi ke definisi pengikatan.
HttpsHelpPageEnabled	Mendapatkan atau menetapkan nilai yang menentukan apakah Windows Communication Foundation (WCF) mengembalikan file bantuan HTML melalui HTTPS di alamat yang dikontrol oleh HttpsHelpPageUrl properti .
HttpsHelpPageUrl	Mendapatkan atau mengatur lokasi di mana file HTML diterbitkan untuk pengambilan menggunakan HTTPS.
IncludeExceptionDetailInFaults	Mendapatkan atau menetapkan nilai yang menentukan apakah akan menyertakan informasi pengecualian terkelola dalam detail kesalahan SOAP yang dikembalikan ke klien untuk tujuan penelusuran kesalahan.

Metode

Nama	Deskripsi
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Implementasi Antarmuka Eksplisit

Nama	Deskripsi
IServiceBehavior.AddBindingParameters(ServiceDescription, ServiceHostBase, Collection<ServiceEndpoint>, BindingParameterCollection)	AddBindingParameters(ServiceDescription, ServiceHostBase, Collection<ServiceEndpoint>, BindingParameterCollection) Menerapkan metode untuk mendukung perilaku.
IServiceBehavior.ApplyDispatchBehavior(ServiceDescription, ServiceHostBase)	ApplyDispatchBehavior(ServiceDescription, ServiceHostBase) Menerapkan metode untuk mendukung perilaku.
IServiceBehavior.Validate(ServiceDescription, ServiceHostBase)	Validate(ServiceDescription, ServiceHostBase) Menerapkan metode untuk mendukung perilaku.

Berlaku untuk

Saran dan Komentar

Apakah halaman ini membantu?