enumerasi WS_ENCODING (webservices.h)

  • Artikel

Pengodean yang berbeda (format pesan).

Sintaks

typedef enum {
  WS_ENCODING_XML_BINARY_1 = 0,
  WS_ENCODING_XML_BINARY_SESSION_1 = 1,
  WS_ENCODING_XML_MTOM_UTF8 = 2,
  WS_ENCODING_XML_MTOM_UTF16BE = 3,
  WS_ENCODING_XML_MTOM_UTF16LE = 4,
  WS_ENCODING_XML_UTF8 = 5,
  WS_ENCODING_XML_UTF16BE = 6,
  WS_ENCODING_XML_UTF16LE = 7,
  WS_ENCODING_RAW = 8
} WS_ENCODING;

Konstanta

 
WS_ENCODING_XML_BINARY_1
Nilai: 0
Pengodean XML biner.


Meskipun data masih dalam XML
format infoset, pengodean ini biasanya menghasilkan pesan yang lebih kecil
yang membutuhkan lebih sedikit CPU untuk diproduksi dan dikonsumsi.


Pengodean ini memerlukan SOAP 1.2 (WS_ENVELOPE_VERSION_SOAP_1_2).
WS_ENCODING_XML_BINARY_SESSION_1
Nilai: 1
Pengodean sesi XML biner.


Meskipun data masih dalam XML
format infoset, pengodean ini biasanya menghasilkan pesan yang lebih kecil
yang membutuhkan lebih sedikit CPU untuk diproduksi dan dikonsumsi.


Pengodean ini seperti WS_ENCODING_XML_BINARY_1 tetapi menambahkan
fitur kamus sesi. Karena pengodean ini memerlukan
sesi, hanya dapat digunakan pada jenis saluran yang penuh sesi
(WS_CHANNEL_TYPE_DUPLEX_SESSION).


Kamus sesi adalah struktur data yang dikelola oleh kedua
mengirim dan menerima sisi saluran. Kamus sesi
digunakan untuk mengoptimalkan transmisi data string. Pertama kali
string tertentu ditulis, dikodekan menggunakan dalam string lengkap
format. Jika string yang sama ditulis lagi, maka string tersebut akan menggunakan string yang lebih kecil
formulir yang ditokenisasi, yang dapat mengurangi ukuran pesan.


Penulis data string memilih string mana yang menjadi kandidat
kamus sesi dengan mengisi kamus dan bidang id dari
struktur WS_XML_STRING .


Ukuran kamus sesi dikonfigurasi menggunakan
WS_CHANNEL_PROPERTY_MAX_SESSION_DICTIONARY_SIZE.


Pengodean ini memerlukan SOAP 1.2 (WS_ENVELOPE_VERSION_SOAP_1_2).
WS_ENCODING_XML_MTOM_UTF8
Nilai: 2
Pengodean MTOM.


Pengodean MTOM mengoptimalkan data biner dengan menghindari biaya
mengonversi data biner ke format base64. Untuk pesan yang berisi
sejumlah besar data biner, pengodean ini biasanya menghasilkan lebih kecil
pesan yang memerlukan lebih sedikit CPU untuk diproduksi dan dikonsumsi
daripada dengan pengodean teks. Pengodean ini biasanya tidak seefisien
namun, pengodean biner.


Bagian XML dari paket MTOM ditulis
menggunakan WS_CHARSET_UTF8, tetapi mungkin berada di WS_CHARSET apa pun saat membaca.
WS_ENCODING_XML_MTOM_UTF16BE
Nilai: 3
Pengodean MTOM.


Pengodean MTOM mengoptimalkan data biner dengan menghindari biaya
mengonversi data biner ke format base64. Untuk pesan yang berisi
sejumlah besar data biner, pengodean ini biasanya menghasilkan lebih kecil
pesan yang memerlukan lebih sedikit CPU untuk diproduksi dan dikonsumsi
daripada dengan pengodean teks. Pengodean ini biasanya tidak seefisien
namun, pengodean biner.


Bagian XML dari paket MTOM ditulis
menggunakan WS_CHARSET_UTF16BE, tetapi mungkin berada di WS_CHARSET apa pun saat membaca.
WS_ENCODING_XML_MTOM_UTF16LE
Nilai: 4
Pengodean MTOM.


Pengodean MTOM mengoptimalkan data biner dengan menghindari biaya
mengonversi data biner ke format base64. Untuk pesan yang berisi
sejumlah besar data biner, pengodean ini biasanya menghasilkan lebih kecil
pesan yang memerlukan lebih sedikit CPU untuk diproduksi dan dikonsumsi
daripada dengan pengodean teks. Pengodean ini biasanya tidak seefisien
namun, pengodean biner.


Bagian XML dari paket MTOM ditulis
menggunakan WS_CHARSET_UTF16LE, tetapi mungkin berada di WS_CHARSET apa pun saat membaca.
WS_ENCODING_XML_UTF8
Nilai: 5
Pengodean teks (format XML 1.0).


Data ditulis menggunakan WS_CHARSET_UTF8,
tetapi mungkin berada di WS_CHARSET mana pun saat membaca.
WS_ENCODING_XML_UTF16BE
Nilai: 6
Pengodean teks (format XML 1.0).


Data ditulis menggunakan WS_CHARSET_UTF16BE,
tetapi mungkin berada di WS_CHARSET mana pun saat membaca.
WS_ENCODING_XML_UTF16LE
Nilai: 7
Pengodean teks (format XML 1.0).


Data ditulis menggunakan WS_CHARSET_UTF16LE,
tetapi mungkin berada di WS_CHARSET mana pun saat membaca.
WS_ENCODING_RAW
Nilai: 8

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 7 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2008 R2 [aplikasi desktop | Aplikasi UWP]
Header webservices.h