Compartilhar via


enumeração WS_ENCODING (webservices.h)

As diferentes codificações (formatos de mensagem).

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;

Constantes

 
WS_ENCODING_XML_BINARY_1
Valor: 0
A codificação XML binária.


Embora os dados ainda estejam no XML
formato de infoset, essa codificação normalmente resulta em mensagens menores
que exigem menos CPU para produzir e consumir.


Essa codificação requer SOAP 1.2 (WS_ENVELOPE_VERSION_SOAP_1_2).
WS_ENCODING_XML_BINARY_SESSION_1
Valor: 1
A codificação de sessão XML binária.


Embora os dados ainda estejam no XML
formato de infoset, essa codificação normalmente resulta em mensagens menores
que exigem menos CPU para produzir e consumir.


Essa codificação é como WS_ENCODING_XML_BINARY_1 , mas adiciona o
recurso de um dicionário de sessão. Como essa codificação requer um
sessão, ele só pode ser usado em tipos de canal com sessão
(WS_CHANNEL_TYPE_DUPLEX_SESSION).


O dicionário de sessão é uma estrutura de dados mantida por ambos os
enviar e receber lado de um canal. O dicionário de sessão
é usado para otimizar a transmissão de dados de cadeia de caracteres. A primeira vez
uma cadeia de caracteres específica é escrita, ela é codificada usando na cadeia de caracteres completa
. Se a mesma cadeia de caracteres for gravada novamente, ela usará uma menor
formulário tokenizado, que pode reduzir o tamanho da mensagem.


O gravador dos dados de cadeia de caracteres seleciona quais cadeias de caracteres são candidatas
o dicionário de sessão preenchendo os campos dicionário e id de
a estrutura WS_XML_STRING .


O tamanho do dicionário de sessão é configurado usando
WS_CHANNEL_PROPERTY_MAX_SESSION_DICTIONARY_SIZE.


Essa codificação requer SOAP 1.2 (WS_ENVELOPE_VERSION_SOAP_1_2).
WS_ENCODING_XML_MTOM_UTF8
Valor: 2
A codificação MTOM.


A codificação MTOM otimiza para dados binários evitando os custos
de converter dados binários no formato base64. Para mensagens que contêm
grandes quantidades de dados binários, essa codificação geralmente resulta em menor
mensagens que exigem menos CPU para produzir e consumir
do que com uma codificação de texto. Essa codificação normalmente não é tão eficiente quanto
no entanto, uma codificação binária.


A parte XML do pacote MTOM é gravada
usando WS_CHARSET_UTF8, mas pode estar em qualquer WS_CHARSET quando lido.
WS_ENCODING_XML_MTOM_UTF16BE
Valor: 3
A codificação MTOM.


A codificação MTOM otimiza para dados binários evitando os custos
de converter dados binários no formato base64. Para mensagens que contêm
grandes quantidades de dados binários, essa codificação geralmente resulta em menor
mensagens que exigem menos CPU para produzir e consumir
do que com uma codificação de texto. Essa codificação normalmente não é tão eficiente quanto
no entanto, uma codificação binária.


A parte XML do pacote MTOM é gravada
usando WS_CHARSET_UTF16BE, mas pode estar em qualquer WS_CHARSET quando lido.
WS_ENCODING_XML_MTOM_UTF16LE
Valor: 4
A codificação MTOM.


A codificação MTOM otimiza para dados binários evitando os custos
de converter dados binários no formato base64. Para mensagens que contêm
grandes quantidades de dados binários, essa codificação geralmente resulta em menor
mensagens que exigem menos CPU para produzir e consumir
do que com uma codificação de texto. Essa codificação normalmente não é tão eficiente quanto
no entanto, uma codificação binária.


A parte XML do pacote MTOM é gravada
usando WS_CHARSET_UTF16LE, mas pode estar em qualquer WS_CHARSET quando lido.
WS_ENCODING_XML_UTF8
Valor: 5
A codificação de texto (formato XML 1.0).


Os dados são gravados usando WS_CHARSET_UTF8,
mas pode estar em qualquer WS_CHARSET quando lido.
WS_ENCODING_XML_UTF16BE
Valor: 6
A codificação de texto (formato XML 1.0).


Os dados são gravados usando WS_CHARSET_UTF16BE,
mas pode estar em qualquer WS_CHARSET quando lido.
WS_ENCODING_XML_UTF16LE
Valor: 7
A codificação de texto (formato XML 1.0).


Os dados são gravados usando WS_CHARSET_UTF16LE,
mas pode estar em qualquer WS_CHARSET quando lido.
WS_ENCODING_RAW
Valor: 8

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Cabeçalho webservices.h