共用方式為

WS_ENCODING列舉 (webservices.h)

  • 發行項

不同的編碼方式 (訊息格式) 。

Syntax

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;

常數

 
WS_ENCODING_XML_BINARY_1
值： 0
二進位 XML 編碼。


雖然數據仍在 XML 中
infoset 格式，此編碼通常會產生較小的訊息
需要較少的CPU才能產生及取用。


此編碼需要 SOAP 1.2 (WS_ENVELOPE_VERSION_SOAP_1_2) 。
WS_ENCODING_XML_BINARY_SESSION_1
值： 1
二進位 XML 會話編碼。


雖然數據仍在 XML 中
infoset 格式，此編碼通常會產生較小的訊息
需要較少的CPU才能產生及取用。


此編碼方式就像 WS_ENCODING_XML_BINARY_1， 但會新增
會話字典的功能。 因為此編碼需要
會話，它只能用於會話通道類型
(WS_CHANNEL_TYPE_DUPLEX_SESSION) 。


會話字典是由 兩者維護的數據結構
傳送和接收通道的端。 會話字典
用來優化字串數據的傳輸。 第一次
寫入特定字串，它會在完整字串中使用 進行編碼
format。 如果再次寫入相同的字串，則會使用較小的字串
tokenized 窗體，可減少訊息大小。


字串數據的寫入器會選取哪些字串是候選字串
填寫 的字典和標識符字段，以取得會話字典
WS_XML_STRING結構。


會話字典的大小是使用 設定的
WS_CHANNEL_PROPERTY_MAX_SESSION_DICTIONARY_SIZE。


此編碼需要 SOAP 1.2 (WS_ENVELOPE_VERSION_SOAP_1_2) 。
WS_ENCODING_XML_MTOM_UTF8
值： 2
MTOM 編碼。


MTOM 編碼可藉由避免成本來優化二進位數據
，將二進位數據轉換成base64格式。 針對包含的訊息
大量的二進位數據，此編碼通常會導致較小的
需要較少的 CPU 來產生及取用的訊息
比使用文字編碼。 此編碼通常不如有效率
不過，二進位編碼。


MTOM 套件的 XML 部分會寫入
使用 WS_CHARSET_UTF8，但可能會在讀取時位於任何 WS_CHARSET 中。
WS_ENCODING_XML_MTOM_UTF16BE
值： 3
MTOM 編碼。


MTOM 編碼可藉由避免成本來優化二進位數據
，將二進位數據轉換成base64格式。 針對包含的訊息
大量的二進位數據，此編碼通常會導致較小的
需要較少的 CPU 來產生及取用的訊息
比使用文字編碼。 此編碼通常不如有效率
不過，二進位編碼。


MTOM 套件的 XML 部分會寫入
使用 WS_CHARSET_UTF16BE，但在讀取時可能位於任何 WS_CHARSET 中。
WS_ENCODING_XML_MTOM_UTF16LE
值： 4
MTOM 編碼。


MTOM 編碼可藉由避免成本來優化二進位數據
，將二進位數據轉換成base64格式。 針對包含的訊息
大量的二進位數據，此編碼通常會導致較小的
需要較少的 CPU 來產生及取用的訊息
比使用文字編碼。 此編碼通常不如有效率
不過，二進位編碼。


MTOM 套件的 XML 部分會寫入
使用 WS_CHARSET_UTF16LE，但在讀取時可能位於任何 WS_CHARSET 中。
WS_ENCODING_XML_UTF8
值： 5
XML 1.0 格式 (文字編碼) 。


數據是使用 WS_CHARSET_UTF8 撰寫的，
但可能會在讀取時處於任何 WS_CHARSET 中。
WS_ENCODING_XML_UTF16BE
值： 6
XML 1.0 格式 (文字編碼) 。


數據是使用 WS_CHARSET_UTF16BE 撰寫的，
但可能會在讀取時處於任何 WS_CHARSET 中。
WS_ENCODING_XML_UTF16LE
值： 7
XML 1.0 格式 (文字編碼) 。


數據是使用 WS_CHARSET_UTF16LE 撰寫的，
但可能會在讀取時處於任何 WS_CHARSET 中。
WS_ENCODING_RAW
值： 8

規格需求

需求 值
最低支援的用戶端 Windows 7 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 R2 [傳統型應用程式 |UWP 應用程式]
標頭 webservices.h