<webHttpBinding>

Menentukan elemen pengikatan yang digunakan untuk mengonfigurasi titik akhir untuk layanan Web Windows Communication Foundation (WCF) yang merespons permintaan HTTP alih-alih pesan SOAP.

<configuration>
  <system.serviceModel>
    <bindings>
      <webHttpBinding>

Syntax

<webHttpBinding>
  <binding allowCookies="Boolean"
           bypassProxyOnLocal="Boolean"
           closeTimeout="TimeSpan"
           hostNameComparisonMode="StrongWildCard/Exact/WeakWildcard"
           maxBufferPoolSize="integer"
           maxBufferSize="integer"
           maxReceivedMessageSize="Integer"
           name="string"
           openTimeout="TimeSpan"
           proxyAddress="URI"
           receiveTimeout="TimeSpan"
           sendTimeout="TimeSpan"
           transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse"
           useDefaultWebProxy="Boolean"
           writeEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding">
    <security mode="None/Transport/TransportCredentialOnly">
      <transport clientCredentialType="Basic/Certificate/Digest/None/Ntlm/Windows"
                 proxyCredentialType="Basic/Digest/None/Ntlm/Windows"
                 realm="string" />
    </security>
    <readerQuotas maxArrayLength="Integer"
                  maxBytesPerRead="Integer"
                  maxDepth="Integer"
                  maxNameTableCharCount="Integer"
                  maxStringContentLength="Integer" />
  </binding>
</webHttpBinding>

Atribut dan Elemen

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

Attributes

Attribute Description
allowCookies Nilai Boolean yang menunjukkan apakah klien menerima cookie dan menyebarkannya pada permintaan di masa mendatang. Defaultnya adalah false.

Anda dapat menggunakan properti ini saat berinteraksi dengan layanan Web ASMX yang menggunakan cookie. Dengan cara ini, Anda dapat yakin bahwa cookie yang dikembalikan dari server secara otomatis disalin ke semua permintaan klien di masa mendatang untuk layanan tersebut.
bypassProxyOnLocal Nilai Boolean yang menunjukkan apakah akan melewati server proksi untuk alamat lokal. Defaultnya adalah false.
closeTimeout Nilai TimeSpan yang menentukan interval waktu yang disediakan agar operasi dekat selesai. Nilai ini harus lebih besar dari atau sama dengan Zero. Defaultnya adalah 00:01:00.
hostnameComparisonMode Menentukan mode perbandingan nama host HTTP yang digunakan untuk mengurai URI. Atribut ini berjenis HostNameComparisonMode, yang menunjukkan apakah nama host digunakan untuk menjangkau layanan saat cocok pada URI. Nilai defaultnya adalah StrongWildcard, yang mengabaikan nama host dalam kecocokan.
maxBufferPoolSize Bilangan bulat yang menentukan ukuran kumpulan buffer maksimum untuk pengikatan ini. Defaultnya adalah 524.288 byte (512 * 1024). Banyak bagian dari Windows Communication Foundation (WCF) menggunakan buffer. Membuat dan menghancurkan buffer setiap kali digunakan mahal, dan pengumpulan sampah untuk buffer juga mahal. Dengan kumpulan buffer, Anda dapat mengambil buffer dari kumpulan, menggunakannya, dan mengembalikannya ke kumpulan setelah selesai. Dengan demikian overhead dalam membuat dan menghancurkan buffer dihindari.
maxBufferSize Bilangan bulat yang menentukan jumlah maksimum memori yang dialokasikan untuk digunakan oleh manajer buffer pesan yang menerima pesan dari saluran. Nilai defaultnya adalah 524.288 (0x80000) byte.
maxReceivedMessageSize Bilangan bulat positif yang menentukan ukuran pesan maksimum, dalam byte, termasuk header, yang dapat diterima pada saluran yang dikonfigurasi dengan pengikatan ini. Pengirim pesan yang melebihi batas ini akan menerima kesalahan. Penerima menghilangkan pesan dan membuat entri peristiwa di log jejak. Defaultnya adalah 65536. Catatan: Meningkatkan nilai ini saja tidak cukup dalam mode ASP.NET kompatibel. Anda juga harus meningkatkan nilai httpRuntime (lihat HttpRuntime Element (ASP.NET Skema Pengaturan)).
Nama String yang berisi nama konfigurasi pengikatan. Nilai ini harus unik karena digunakan sebagai identifikasi untuk pengikatan. Dimulai dengan .NET Framework 4, pengikatan dan perilaku tidak diperlukan untuk memiliki nama. Untuk informasi selengkapnya tentang konfigurasi default dan pengikatan dan perilaku tanpa nama, lihat Konfigurasi Yang Disederhanakan dan Konfigurasi Yang Disederhanakan untuk Layanan WCF.
openTimeout TimeSpan Nilai yang menentukan interval waktu yang disediakan agar operasi terbuka selesai. Nilai ini harus lebih besar dari atau sama dengan Zero. Defaultnya adalah 00:01:00.
proxyAddress URI yang menentukan alamat proksi HTTP. Jika useSystemWebProxy adalah true, pengaturan ini harus null. Defaultnya adalah null.
receiveTimeout Nilai TimeSpan yang menentukan interval waktu yang disediakan agar operasi penerima selesai. Nilai ini harus lebih besar dari atau sama dengan Zero. Defaultnya adalah 00:01:00.
sendTimeout Nilai TimeSpan yang menentukan interval waktu yang disediakan agar operasi pengiriman selesai. Nilai ini harus lebih besar dari atau sama dengan Zero. Defaultnya adalah 00:01:00.
transferMode. TransferMode Nilai yang menunjukkan apakah layanan yang dikonfigurasi dengan pengikatan menggunakan mode transfer pesan yang dialirkan atau di-buffer (atau keduanya). Defaultnya adalah Buffered.
useDefaultWebProxy Nilai Boolean yang menentukan apakah proksi HTTP yang dikonfigurasi otomatis sistem digunakan. Defaultnya adalah true.
writeEncoding Menentukan pengodean karakter yang digunakan untuk teks pesan. Nilai yang valid mencakup yang berikut ini:

UnicodeFffeTextEncoding: Pengodean Unicode BigEndian.

Utf16TextEncoding: Pengodean 16-bit.

Utf8TextEncoding: Pengodean 8-bit.

Defaultnya adalah Utf8TextEncoding.

Elemen Anak

Elemen Description
<readerQuotas> Menentukan batasan pada kompleksitas pesan POX yang dapat diproses oleh titik akhir yang dikonfigurasi dengan pengikatan ini. Elemen ini berjenis XmlDictionaryReaderQuotasElement.
<keamanan> Menentukan pengaturan keamanan untuk pengikatan. Elemen ini berjenis WebHttpSecurityElement.

Elemen Induk

Elemen Description
<Binding> Elemen ini menyimpan kumpulan pengikatan standar dan kustom.

Komentar

Model Pemrograman Web WCF memungkinkan pengembang mengekspos layanan Web WCF melalui permintaan HTTP yang menggunakan pesan gaya "XML lama biasa" (POX) alih-alih olahpesan berbasis SOAP. Agar klien berkomunikasi dengan layanan menggunakan permintaan HTTP, titik akhir layanan harus dikonfigurasi dengan <webHttpBinding> yang memiliki <WebHttpBehavior> yang melekat padanya.

Dukungan di WCF untuk sindikasi dan ASP. Integrasi AJAX keduanya dibangun di atas Model Pemrograman Web. Untuk informasi selengkapnya tentang model, lihat Model Pemrograman HTTP Web WCF.

Lihat juga

  • Last updated on