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 |