<textMessageEncoding>

Artikel
06/08/2023

Menentukan pengodean karakter dan versi pesan yang digunakan untuk pesan XML berbasis teks.

<konfigurasi>
  <system.serviceModel>
    <bindings>
      <customBinding>
        <pengikatan>
          <textMessageEncoding>

Sintaks

<textMessageEncoding maxReadPoolSize="Integer"
                     maxWritePoolSize="Integer"
                     messageVersion="Soap11Addressing10/Soap12Addressing10"
                     writeEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding" />

Atribut dan Elemen

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

Atribut

Atribut	Deskripsi
maxReadPoolSize	Bilangan bulat yang menentukan berapa banyak pesan yang bisa dibaca secara bersamaan tanpa mengalokasikan pembaca baru. Ukuran kolam yang lebih besar membuat sistem lebih toleran terhadap lonjakan aktivitas dengan mengorbankan set kerja yang lebih besar. Defaultnya adalah "64".
maxWritePoolSize	Bilangan bulat yang menentukan berapa banyak pesan yang bisa dikirim secara bersamaan tanpa mengalokasikan penulis baru. Ukuran kolam yang lebih besar membuat sistem lebih toleran terhadap lonjakan aktivitas dengan mengorbankan set kerja yang lebih besar. Secara default adalah 16%.
messageVersion	Menentukan versi SOAP dari pesan yang dikirim menggunakan pengikatan. Nilai yang valid adalah - Soap11Addressing10 - Soap12Addressing10 - Soap11 - Soap12 Defaultnya adalah Soap12Addressing10. Atribut ini berjenis MessageVersion.
writeEncoding	Menentukan pengkodean set karakter yang akan digunakan untuk mengirimkan pesan pada pengikatan. Nilai yang valid adalah - UnicodeFffeTextEncoding: Unicode BigEndian encoding - Utf16TextEncoding: Pengkodean Unicode - Utf8TextEncoding: pengkodean 8-bit Defaultnya adalah Utf8TextEncoding. Atribut ini berjenis Encoding.

Elemen Anak

Elemen	Deskripsi
<readerQuotas>	Mendefinisikan batasan pada kompleksitas pesan SOAP yang dapat diproses oleh titik akhir yang dikonfigurasi dengan pengikatan ini. Elemen ini berjenis XmlDictionaryReaderQuotasElement.

Elemen Induk

Elemen	Deskripsi
<pengikatan>	Menentukan semua kemampuan pengikatan dari pengikatan kustom.

Keterangan

Pengodean adalah proses mengubah pesan menjadi urutan byte. Decoding adalah proses sebaliknya. Windows Communication Foundation (WCF) mencakup tiga jenis pengkodean untuk pesan SOAP: Text, Binary and Message Transmission Optimization Mechanism (MTOM).

Pengodean teks yang diwakili oleh textMessageEncoding elemen adalah yang paling bisa dioperasikan, tetapi encoder yang paling tidak efisien untuk pesan XML. Encoder teks membuat pesan berbasis teks pada kawat. Pesan yang dihasilkan oleh encoder ini cocok untuk interop berbasis WS*. Layanan web atau klien layanan Web umumnya bisa memahami XML tekstual. Namun, mentransmisikan blok besar data biner sebagai teks adalah metode yang paling tidak efisien untuk pengkodean pesan XML.

Contoh

<textMessageEncoding maxReadPoolSize="211"
                     maxWritePoolSize="2132"
                     messageVersion="Soap12Addressing10"
                     textEncoding="utf-8" />

Bagikan melalui