Condividi tramite


enumerazione WS_ENCODING (webservices.h)

Le diverse codifiche (formati di messaggio).

Sintassi

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;

Costanti

 
WS_ENCODING_XML_BINARY_1
Valore: 0
Codifica XML binaria.


Anche se i dati sono ancora nel codice XML
formato infoset, questa codifica genera in genere messaggi più piccoli
che richiedono meno CPU per produrre e utilizzare.


Questa codifica richiede SOAP 1.2 (WS_ENVELOPE_VERSION_SOAP_1_2).
WS_ENCODING_XML_BINARY_SESSION_1
Valore: 1
Codifica di sessione XML binaria.


Anche se i dati sono ancora nel codice XML
formato infoset, questa codifica genera in genere messaggi più piccoli
che richiedono meno CPU per produrre e utilizzare.


Questa codifica è simile a WS_ENCODING_XML_BINARY_1 ma aggiunge
funzionalità di un dizionario di sessione. Poiché questa codifica richiede un
sessione, può essere usata solo nei tipi di canale con sessione
(WS_CHANNEL_TYPE_DUPLEX_SESSION).


Il dizionario di sessione è una struttura di dati gestita da entrambi i
invio e ricezione del lato di un canale. Dizionario di sessione
viene usato per ottimizzare la trasmissione di dati stringa. La prima volta
viene scritta una particolare stringa, che viene codificata usando nella stringa completa
. Se la stessa stringa viene scritta di nuovo, userà una stringa più piccola
modulo con token, che può ridurre le dimensioni dei messaggi.


Il writer dei dati stringa seleziona quali stringhe sono candidati per
dizionario sessione compilando i campi dizionario e ID di
struttura WS_XML_STRING .


Le dimensioni del dizionario sessione sono configurate tramite
WS_CHANNEL_PROPERTY_MAX_SESSION_DICTIONARY_SIZE.


Questa codifica richiede SOAP 1.2 (WS_ENVELOPE_VERSION_SOAP_1_2).
WS_ENCODING_XML_MTOM_UTF8
Valore: 2
Codifica MTOM.


La codifica MTOM ottimizza i dati binari evitando i costi
di conversione dei dati binari in formato base64. Per i messaggi contenenti
grandi quantità di dati binari, questa codifica in genere comporta dimensioni inferiori
messaggi che richiedono meno CPU per produrre e utilizzare
rispetto a con una codifica di testo. Questa codifica in genere non è così efficiente quanto
una codifica binaria, tuttavia.


La parte XML del pacchetto MTOM è scritta
utilizzando WS_CHARSET_UTF8, ma può trovarsi in qualsiasi WS_CHARSET durante la lettura.
WS_ENCODING_XML_MTOM_UTF16BE
Valore: 3
Codifica MTOM.


La codifica MTOM ottimizza i dati binari evitando i costi
di conversione dei dati binari in formato base64. Per i messaggi contenenti
grandi quantità di dati binari, questa codifica in genere comporta dimensioni inferiori
messaggi che richiedono meno CPU per produrre e utilizzare
rispetto a con una codifica di testo. Questa codifica in genere non è così efficiente quanto
una codifica binaria, tuttavia.


La parte XML del pacchetto MTOM è scritta
utilizzando WS_CHARSET_UTF16BE, ma può trovarsi in qualsiasi WS_CHARSET durante la lettura.
WS_ENCODING_XML_MTOM_UTF16LE
Valore: 4
Codifica MTOM.


La codifica MTOM ottimizza i dati binari evitando i costi
di conversione dei dati binari in formato base64. Per i messaggi contenenti
grandi quantità di dati binari, questa codifica in genere comporta dimensioni inferiori
messaggi che richiedono meno CPU per produrre e utilizzare
rispetto a con una codifica di testo. Questa codifica in genere non è così efficiente quanto
una codifica binaria, tuttavia.


La parte XML del pacchetto MTOM è scritta
utilizzando WS_CHARSET_UTF16LE, ma può trovarsi in qualsiasi WS_CHARSET durante la lettura.
WS_ENCODING_XML_UTF8
Valore: 5
Codifica del testo (formato XML 1.0).


I dati sono scritti usando WS_CHARSET_UTF8,
ma può trovarsi in qualsiasi WS_CHARSET durante la lettura.
WS_ENCODING_XML_UTF16BE
Valore: 6
Codifica del testo (formato XML 1.0).


I dati sono scritti usando WS_CHARSET_UTF16BE,
ma può trovarsi in qualsiasi WS_CHARSET durante la lettura.
WS_ENCODING_XML_UTF16LE
Valore: 7
Codifica del testo (formato XML 1.0).


I dati sono scritti usando WS_CHARSET_UTF16LE,
ma può trovarsi in qualsiasi WS_CHARSET durante la lettura.
WS_ENCODING_RAW
Valore: 8

Requisiti

Requisito Valore
Client minimo supportato Windows 7 [app desktop | App UWP]
Server minimo supportato Windows Server 2008 R2 [app desktop | App UWP]
Intestazione webservices.h