<ws2007HttpBinding>

Menetapkan pengikatan dan dapat dioperasikan yang menyediakan dukungan untuk elemen pengikatan Security, ReliableSession, dan TransactionFlow dengan versi yang benar.

<konfigurasi>
  <system.serviceModel>
    <pengikatan>
      <ws2007HttpBinding>

Sintaks

<ws2007HttpBinding>
  <binding allowCookies="Boolean"
           bypassProxyOnLocal="Boolean"
           closeTimeout="TimeSpan"
           hostNameComparisonMode="StrongWildCard/Exact/WeakWildcard"
           maxBufferPoolSize="integer"
           maxReceivedMessageSize="Integer"
           messageEncoding="Text/Mtom"
           name="string"
           openTimeout="TimeSpan"
           proxyAddress="URI"
           receiveTimeout="TimeSpan"
           sendTimeout="TimeSpan"
           textEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding"
           transactionFlow="Boolean"
           useDefaultWebProxy="Boolean">
    <reliableSession ordered="Boolean"
                     inactivityTimeout="TimeSpan"
                     enabled="Boolean" />
    <security mode="Message/None/Transport/TransportWithCredential">
      <transport clientCredentialType="Basic/Certificate/Digest/None/Ntlm/Windows"
                 proxyCredentialType="Basic/Digest/None/Ntlm/Windows"
                 realm="string" />
        <message clientCredentialType ="Certificate/IssuedToken/None/UserName/Windows"
                 negotiateServiceCredential="Boolean"
                 algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"
                 establishSecurityContext="Boolean" />
    </security>
    <readerQuotas maxArrayLength="Integer"
                  maxBytesPerRead="Integer"
                  maxDepth="Integer"
                  maxNameTableCharCount="Integer"
                  maxStringContentLength="Integer" />
  </binding>
</ws2007HttpBinding>

Atribut dan Elemen

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

Atribut

Atribut Deskripsi
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 ASP.NET (ASMX) yang menggunakan cookie. Properti ini memastikan bahwa cookie yang dikembalikan server secara otomatis disalin ke semua permintaan klien di masa mendatang untuk layanan tersebut.
bypassProxyOnLocal Nilai yang menunjukkan apakah akan melewati server proksi untuk alamat lokal. Defaultnya adalah false.
closeTimeout Nilai TimeSpan yang menentukan interval waktu yang disediakan untuk menyelesaikan operasi tertutup. 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 Pengidentifikasi Sumber Daya Seragam (URI). Atribut ini berjenis HostNameComparisonMode, yang menunjukkan apakah nama host digunakan untuk menjangkau layanan saat mencocokkan pada URI. Nilai defaultnya adalah StrongWildcard, yang mengabaikan nama host yang cocok.
maxBufferPoolSize Ukuran kumpulan buffer maksimum untuk pengikatan ini. Defaultnya adalah 524.288 byte (512 x 1.024). Banyak bagian dari Windows Communication Foundation (WCF) menggunakan buffer. Membuat dan menghancurkan buffer setiap kali digunakan itu 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 dapat dihindari.
maxReceivedMessageSize Ukuran pesan maksimum, dalam byte, termasuk header, yang dapat diterima pada saluran yang dikonfigurasi dengan pengikatan ini. Pengirim pesan yang melebihi batas ini menerima kesalahan SOAP. Penerima menghilangkan pesan dan membuat entri peristiwa di log pelacakan. Defaultnya adalah 65536.
messageEncoding Mendefinisikan encoder yang digunakan untuk menyandikan pesan. Nilai yang valid mencakup nilai berikut:

- Text: Menggunakan encoder pesan teks.
- Mtom: Menggunakan encoder Message Transmission Organization Mechanism 1.0 (MTOM).

Defaultnya adalah Text.

Atribut ini berjenis WSMessageEncoding.
name Nama konfigurasi pengikatan. Nilai ini harus unik karena digunakan sebagai identifikasi untuk pengikatan. Dimulai dengan .NET Framework 4, pengikatan dan perilaku tidak perlu memiliki nama. Untuk informasi selengkapnya tentang konfigurasi default dan pengikatan serta perilaku tanpa nama, lihat Konfigurasi yang Disederhanakan dan Konfigurasi yang Disederhanakan untuk Layanan WCF.
openTimeout Nilai TimeSpan yang menentukan interval waktu yang disediakan untuk menyelesaikan operasi terbuka. 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 untuk menyelesaikan operasi penerimaan. Nilai ini harus lebih besar dari atau sama dengan Zero. Defaultnya adalah 00:01:00.
sendTimeout Nilai TimeSpan yang menentukan interval waktu yang disediakan untuk menyelesaikan operasi pengiriman. Nilai ini harus lebih besar dari atau sama dengan Zero. Defaultnya adalah 00:01:00.
textEncoding Menentukan pengodean tataan karakter yang akan digunakan untuk mengirimkan pesan pada pengikatan. Nilai yang valid mencakup nilai berikut:

- UnicodeFffeTextEncoding: Pengodean Unicode Big Endian.
- Utf16TextEncoding: Pengodean 16-bit.
- Utf8TextEncoding: Pengodean 8-bit.

Defaultnya adalah Utf8TextEncoding.

Atribut ini berjenis Encoding.
transactionFlow Nilai yang menentukan apakah pengikatan mendukung Transaksi WS yang mengalir. Defaultnya adalah false.
useDefaultWebProxy Nilai yang menentukan apakah proksi HTTP yang dikonfigurasi otomatis sistem digunakan. Defaultnya adalah true.

Elemen Anak

Elemen Deskripsi
<security> Menentukan pengaturan keamanan untuk pengikatan. Elemen ini berjenis WSHttpSecurityElement.
<readerQuotas> Menentukan batasan pada kompleksitas pesan SOAP yang dapat diproses oleh titik akhir yang dikonfigurasi dengan pengikatan ini. Elemen ini berjenis XmlDictionaryReaderQuotasElement.
<reliableSession> Menentukan apakah sesi yang andal dibuat di antara titik akhir saluran.

Elemen Induk

Elemen Deskripsi
<bindings> Elemen ini menyimpan koleksi pengikatan standar dan kustom.

Keterangan

WS2007HttpBinding menambahkan pengikatan yang disediakan sistem yang mirip dengan WSHttpBinding tetapi menggunakan Organisasi untuk versi standar Advancement of Structured Information Standards (OASIS) dari protokol ReliableSession, Security, dan TransactionFlow. Tidak diperlukan perubahan pada model objek atau pengaturan default saat menggunakan pengikatan ini.

Contoh

<configuration>
  <system.ServiceModel>
    <bindings>
      <ws2007HttpBinding>
        <binding closeTimeout="00:00:10"
                 openTimeout="00:00:20"
                 receiveTimeout="00:00:30"
                 sendTimeout="00:00:40"
                 bypassProxyOnLocal="false"
                 transactionFlow="false"
                 hostNameComparisonMode="WeakWildcard"
                 maxReceivedMessageSize="1000"
                 messageEncoding="Mtom"
                 proxyAddress="http://www.contoso.com"
                 textEncoding="utf-16"
                 useDefaultWebProxy="false">
          <reliableSession ordered="false"
                           inactivityTimeout="00:02:00"
                           enabled="true" />
          <security mode="Transport">
            <transport clientCredentialType="Digest"
                       proxyCredentialType="None"
                       realm="someRealm" />
            <message clientCredentialType="Windows"
                     negotiateServiceCredential="false"
                     algorithmSuite="Aes128"
                     defaultProtectionLevel="None" />
          </security>
        </binding>
      </ws2007HttpBinding>
    </bindings>
  </system.ServiceModel>
</configuration>

Lihat juga