<system.serviceModel>

  • Artikel

Bagian konfigurasi ini berisi semua elemen konfigurasi ServiceModel Windows Communication Foundation (WCF).

<configuration>
  <system.serviceModel>

Sintaks

<system.serviceModel>
  <behaviors>
  </behaviors>
  <bindings>
  </bindings>
  <client>
  </client>
  <comContracts>
  </comContracts>
  <commonBehaviors>
  </commonBehaviors>
  <diagnostics>
  </diagnostics>
  <extensions>
  </extensions>
  <protocolMapping>
  </protocolMapping>
  <routing>
  </routing>
  <serviceHostingEnvironment>
  </serviceHostingEnvironment>
  <services>
  </services>
  <standardEndpoints>
  </standardEndpoints>
  <tracking>
  </tracking>
</system.serviceModel>

Atribut dan Elemen

Bagian berikut menjelaskan atribut, elemen turunan, dan elemen induk.

Atribut

Tidak ada

Elemen Anak

Elemen Deskripsi
<behaviors> Bagian ini mendefinisikan dua koleksi turunan bernama endpointBehaviors dan serviceBehaviors. Setiap koleksi mendefinisikan elemen perilaku yang dikonsumsi oleh titik akhir dan layanan masing-masing. Setiap elemen perilaku diidentifikasi oleh atribut name uniknya.
<pengikatan> Bagian ini menyimpan koleksi pengikatan standar dan kustom. Setiap entri diidentifikasi oleh name-nya yang unik. Layanan menggunakan pengikatan dengan menautkannya menggunakan name.
<client> Bagian ini berisi daftar titik akhir yang digunakan klien untuk terhubung ke layanan.
<comContracts> Bagian ini mendefinisikan kontrak COM yang diaktifkan untuk interop WCF dan COM.
<commonBehaviors> Bagian ini hanya dapat didefinisikan dalam file machine.config. Bagian ini mendefinisikan dua koleksi turunan bernama endpointBehaviors dan serviceBehaviors. Setiap koleksi mendefinisikan elemen perilaku yang dikonsumsi oleh semua titik akhir dan layanan WCF di mesin masing-masing. Jika perilaku didefinisikan di kedua bagian <commonBehaviors> dan <behaviors>, perilaku di bagian <behaviors> akan diberikan preferensi.
<diagnostics> Bagian ini berisi pengaturan untuk fitur diagnostik WCF. Pengguna dapat mengaktifkan/menonaktifkan penelusuran, penghitung performa, dan penyedia WMI, serta dapat menambahkan filter pesan khusus.
<extensions> Bagian ini berisi kumpulan ekstensi, yang memungkinkan pengguna membuat pengikatan, perilaku, dan aspek ekstensi yang ditentukan pengguna.
<protocolMapping> Bagian ini mendefinisikan serangkaian pemetaan protokol default antara skema protokol transportasi (misalnya, http, net.tcp, net.pipe, dll.) dan pengikatan WCF.
<routing> Bagian ini menentukan sekumpulan filter perutean, yang menentukan jenis Windows Communication Foundation (WCF) MessageFilter yang akan digunakan saat mengevaluasi pesan masuk, serta tabel perutean yang menentukan titik akhir target untuk mengirim pesan saat memfilter kecocokan.
<serviceHostingEnvironment> Bagian ini mendefinisikan instans jenis lingkungan hosting layanan yang dibuat untuk transportasi tertentu. Jika bagian ini kosong, jenis default akan digunakan.
<services> Bagian ini berisi kumpulan layanan. Untuk setiap layanan yang ditentukan dalam assembly, elemen ini berisi elemen service yang menentukan pengaturan untuk layanan.
<standardEndpoints> Bagian ini mendefinisikan kumpulan titik akhir standar, yang merupakan titik akhir yang telah dikonfigurasi sebelumnya yang dapat digunakan kembali. Titik akhir standar akan memiliki satu atau beberapa atribut alamat, pengikatan, dan kontrak yang diatur ke nilai tetap. Misalnya, di titik akhir penemuan kontrak bersifat tetap. Anda juga dapat menggunakan titik akhir standar untuk memperluas titik akhir layanan dengan properti baru yang caranya mirip dengan menentukan pengikatan kustom.
<tracking> Bagian ini menentukan pengaturan pelacakan untuk layanan alur kerja.

Elemen Induk

Elemen Deskripsi
<konfigurasi> Elemen akar untuk semua elemen konfigurasi dalam sebuah file konfigurasi .NET.

Keterangan

WCF tidak menambahkan elemen ke bagian konfigurasi produk lain.

Layanan WCF ditentukan di bagian services file konfigurasi. Assembly dapat berisi sejumlah layanan. Setiap layanan memiliki bagian konfigurasi service-nya sendiri. Bagian dan isinya menentukan kontrak layanan, perilaku, dan titik akhir dari layanan tertentu.

Hanya atribut layanan name yang diperlukan. Secara default, nama layanan menjelaskan jenis CLR yang mendasar yang digunakan untuk mengimplementasikan layanan; namun, Anda dapat mengubah properti ConfigurationName di ServiceContractAttribute untuk mengambil alih persyaratan jenis runtime bahasa umum.

Atribut behaviorConfiguration bersifat opsional. Atribut ini mengidentifikasi perilaku layanan yang digunakan oleh layanan. Perilaku yang ditentukan oleh atribut ini harus ditautkan ke perilaku layanan yang ditentukan dalam cakupan file konfigurasi yang sama (yaitu file yang sama atau file induk).

Setiap layanan mengekspos satu atau beberapa titik akhir yang ditentukan dalam elemen endpoint. Setiap titik akhir memiliki alamat dan pengikatannya sendiri. Semua pengikatan yang digunakan dalam file konfigurasi harus ditentukan dalam cakupan file.

Pengikatan ditautkan ke titik akhir melalui kombinasi atribut name dan bindingConfiguration. Atribut binding menentukan di bagian mana pengikatan ditentukan. Atribut bindingConfiguration menentukan pengikatan terkonfigurasi mana dalam bagian pengikatan yang akan digunakan. Bagian pengikatan dapat menentukan beberapa pengikatan yang dikonfigurasi.

Contoh

Berikut adalah contoh file konfigurasi WCF.

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <system.serviceModel>
    <behaviors>
      <!-- List of Behaviors -->
    </behaviors>
    <client>
      <!-- List of Endpoints -->
    </client>
    <diagnostics wmiProviderEnabled="false"
                 performanceCountersEnabled="false"
                 tracingEnabled="false">
    </diagnostics>
    <serviceHostingEnvironment>
      <!-- List of entries -->
    </serviceHostingEnvironment>
    <comContracts>
      <!-- List of COM+ Contracts -->
    </comContracts>
    <services>
      <!-- List of Services -->
    </services>
    <bindings>
      <!-- List of Bindings -->
    </bindings>
  </system.serviceModel>
</configuration>

Lihat juga