enumerazione WS_XML_READER_PROPERTY_ID (webservices.h)

Identifica ogni proprietà di lettura XML e il relativo valore associato. Questa enumerazione viene usata all'interno della struttura WS_XML_READER_PROPERTY , utilizzata come parametro per WsCreateReader, WsSetInput, WsSetInputToBuffer e WsReadXmlBufferFromBytes. Viene usato direttamente come parametro per WsGetReaderProperty.

Sintassi

typedef enum {
  WS_XML_READER_PROPERTY_MAX_DEPTH = 0,
  WS_XML_READER_PROPERTY_ALLOW_FRAGMENT = 1,
  WS_XML_READER_PROPERTY_MAX_ATTRIBUTES = 2,
  WS_XML_READER_PROPERTY_READ_DECLARATION = 3,
  WS_XML_READER_PROPERTY_CHARSET = 4,
  WS_XML_READER_PROPERTY_ROW = 5,
  WS_XML_READER_PROPERTY_COLUMN = 6,
  WS_XML_READER_PROPERTY_UTF8_TRIM_SIZE = 7,
  WS_XML_READER_PROPERTY_STREAM_BUFFER_SIZE = 8,
  WS_XML_READER_PROPERTY_IN_ATTRIBUTE = 9,
  WS_XML_READER_PROPERTY_STREAM_MAX_ROOT_MIME_PART_SIZE = 10,
  WS_XML_READER_PROPERTY_STREAM_MAX_MIME_HEADERS_SIZE = 11,
  WS_XML_READER_PROPERTY_MAX_MIME_PARTS = 12,
  WS_XML_READER_PROPERTY_ALLOW_INVALID_CHARACTER_REFERENCES = 13,
  WS_XML_READER_PROPERTY_MAX_NAMESPACES = 14
} WS_XML_READER_PROPERTY_ID;

Costanti

WS_XML_READER_PROPERTY_MAX_DEPTH Valore: 0 ULONG che specifica la profondità massima del documento consentito dal lettore. La profondità viene misurata in qualsiasi punto in base al numero di elementi iniziali annidati. Una profondità di 0 impedisce la lettura di elementi iniziali. Questa proprietà viene impostata su 32. Per considerazioni sulla sicurezza, vedere WsCreateReader .
WS_XML_READER_PROPERTY_ALLOW_FRAGMENT Valore: 1 Valore BOOL che specifica se il lettore consentirà più elementi e spazi non vuoti a livello superiore del documento. Questa proprietà potrebbe non essere impostato su TRUE con WS_XML_READER_MTOM_ENCODING. Questa proprietà viene predefinita su FALSE.
WS_XML_READER_PROPERTY_MAX_ATTRIBUTES Valore: 2 ULONG che specifica il numero massimo di attributi consentiti dal lettore in un elemento. Questa proprietà viene impostata su 128. Per considerazioni sulla sicurezza, vedere WsCreateReader .
WS_XML_READER_PROPERTY_READ_DECLARATION Valore: 3 Valore BOOL che specifica se il lettore deve consentire una dichiarazione xml all'inizio del documento. Questa proprietà è impostata su TRUE.
WS_XML_READER_PROPERTY_CHARSET Valore: 4 Valore WS_CHARSET che restituisce il set di caratteri del documento xml. Questo valore è disponibile solo per documenti di testo. Se il lettore è stato inizializzato con un WS_CHARSET_AUTO , determina automaticamente questo Valore. L'origine di input lettore è in streaming, quindi il lettore deve avere un buffer di dati sufficiente per poter essere in grado di esaminare i contrassegni di ordine di byte iniziali e la dichiarazione xml. Vedere WsFillReader. Se il lettore è stato inizializzato con qualsiasi altro valore, questa proprietà restituisce semplicemente tale valore.
WS_XML_READER_PROPERTY_ROW Valore: 5 ULONGLONG che restituisce il numero di riga basato su 0 del nodo in cui viene posizionato il lettore per i documenti xml di testo.
WS_XML_READER_PROPERTY_COLUMN Valore: 6 ULONGLONG che restituisce il numero di colonna basato su 0 del nodo in cui viene posizionato il lettore per i documenti xml di testo.
WS_XML_READER_PROPERTY_UTF8_TRIM_SIZE Valore: 7 ULONG che specifica le dimensioni di taglio del buffer interno utilizzato dall'oggetto WS_XML_READER per eseguire conversioni UTF-16 a UTF-8. Aumento di questo valore usa più memoria, ma può ridurre le allocazioni durante l'elaborazione di documenti codificati UTF-16. Questa proprietà viene impostata su 4096.
WS_XML_READER_PROPERTY_STREAM_BUFFER_SIZE Valore: 8 ULONG che specifica le dimensioni del buffer che il WS_XML_READER userà quando configurato per l'uso WS_XML_READER_STREAM_INPUT. L'aumento di questo valore usa più memoria, ma può ridurre il numero di volte in cui viene richiamata la WS_READ_CALLBACK . Questa proprietà viene impostata su 4096.
WS_XML_READER_PROPERTY_IN_ATTRIBUTE Valore: 9 Indica che WsReadStartAttribute è stato chiamato e il lettore è posizionato sul contenuto dell'attributo.
WS_XML_READER_PROPERTY_STREAM_MAX_ROOT_MIME_PART_SIZE Valore: 10 ULONG usato con WS_XML_READER_STREAM_INPUT insieme a WS_XML_READER_MTOM_ENCODING. Questo valore specifica le dimensioni massime della parte MIME radice, ovvero la parte che contiene parte xml del documento. Non ha alcun effetto quando viene usato con altre codifiche o quando usato con WS_XML_READER_BUFFER_INPUT. Questa proprietà viene impostata su 65536.
WS_XML_READER_PROPERTY_STREAM_MAX_MIME_HEADERS_SIZE Valore: 11 ULONG usato con WS_XML_READER_STREAM_INPUT insieme a WS_XML_READER_MTOM_ENCODING. Questo valore specifica la dimensione massima di qualsiasi gruppo di intestazioni MIME che possono essere visualizzate nel documento. Non ha alcun effetto quando viene usato con altre codifiche o quando usato con WS_XML_READER_BUFFER_INPUT. Questa proprietà viene impostata su 256.
WS_XML_READER_PROPERTY_MAX_MIME_PARTS Valore: 12 ULONG usato con WS_XML_READER_MTOM_ENCODING. Questo valore specifica il numero massimo di parti MIME che può essere visualizzato nel documento. Non ha alcun effetto quando viene usato con altre codifiche. Questa proprietà viene impostata su 4096.
WS_XML_READER_PROPERTY_ALLOW_INVALID_CHARACTER_REFERENCES Valore: 13 Valore BOOL usato con WS_XML_READER_TEXT_ENCODING. L'impostazione di questa opzione su TRUE consente riferimenti ai caratteri di caratteri considerati non validi da XML 1.0 da accettare. L'impostazione di questa proprietà su TRUE può influire sull'interoperabilità. Questa proprietà viene predefinita su FALSE.
WS_XML_READER_PROPERTY_MAX_NAMESPACES Valore: 14 ULONG che specifica il numero massimo di dichiarazioni univoche xmlns che possono essere visualizzate nell'ambito in qualsiasi punto durante la lettura del documento. Questa proprietà viene impostata su 32. Per considerazioni sulla sicurezza, vedere WsCreateReader .

Requisiti

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