Compartilhar via

enumeração WS_XML_READER_PROPERTY_ID (webservices.h)

  • Artigo

Identifica cada propriedade de leitor XML e seu valor associado. Essa enumeração é usada na estrutura WS_XML_READER_PROPERTY , que é usada como um parâmetro para WsCreateReader, WsSetInput, WsSetInputToBuffer e WsReadXmlBufferFromBytes. Ele também é usado diretamente como um parâmetro para WsGetReaderProperty.

Syntax

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;

Constantes

 
WS_XML_READER_PROPERTY_MAX_DEPTH
Valor: 0
Um ULONG que especifica a profundidade máxima do documento que o leitor permitirá.


A profundidade é medida a qualquer momento pelo número de elementos iniciais aninhados.


Uma profundidade de 0 impede que todos os elementos iniciais sejam lidos.


Essa propriedade usa como padrão 32.


Consulte WsCreateReader para obter considerações de segurança.
WS_XML_READER_PROPERTY_ALLOW_FRAGMENT
Valor: 1
Um BOOL que
especifica se o leitor permitirá vários elementos e espaço não branco no nível superior do documento. Esta propriedade
pode não ser definido como TRUE com WS_XML_READER_MTOM_ENCODING.


Essa propriedade usa como padrão FALSE.
WS_XML_READER_PROPERTY_MAX_ATTRIBUTES
Valor: 2
Um ULONG que especifica o número máximo de atributos que o leitor permitirá em um elemento.


Essa propriedade usa como padrão 128.


Consulte WsCreateReader para obter considerações de segurança.
WS_XML_READER_PROPERTY_READ_DECLARATION
Valor: 3
Um BOOL que especifica se o leitor deve permitir uma declaração xml no início do documento.


Essa propriedade usa como padrão TRUE.
WS_XML_READER_PROPERTY_CHARSET
Valor: 4
Um valor WS_CHARSET que retorna o conjunto de caracteres do documento xml. Esse valor só está disponível para
documentos de texto.


Se o leitor foi inicializado com um WS_CHARSET_AUTO , ele determinará isso automaticamente
value. A fonte de entrada do leitor é transmitida e, em seguida, o leitor deve ter dados suficientes armazenados em buffer para poder
inspecione as marcas de ordem de bytes iniciais e a declaração xml. Consulte WsFillReader.


Se o leitor foi inicializado com qualquer outro valor, essa propriedade simplesmente retorna esse valor.
WS_XML_READER_PROPERTY_ROW
Valor: 5
Um ULONGLONG que retorna o número de linha baseado em 0 do nó em que o leitor está posicionado para documentos xml de texto.
WS_XML_READER_PROPERTY_COLUMN
Valor: 6
Um ULONGLONG que retorna o número de coluna baseado em 0 do nó em que o leitor está posicionado para documentos xml de texto.
WS_XML_READER_PROPERTY_UTF8_TRIM_SIZE
Valor: 7
Um ULONG que especifica o tamanho de corte do buffer interno usado pelo
WS_XML_READER para executar conversões UTF-16 para UTF-8. Aumentando esse valor
usa mais memória, mas pode reduzir alocações ao processar documentos codificados em UTF-16.


Essa propriedade usa como padrão 4096.
WS_XML_READER_PROPERTY_STREAM_BUFFER_SIZE
Valor: 8
Um ULONG que especifica o tamanho do buffer que o WS_XML_READER usará quando configurado para uso
WS_XML_READER_STREAM_INPUT. Aumentar esse valor usa mais memória, mas
pode reduzir o número de vezes que o WS_READ_CALLBACK é invocado.


Essa propriedade usa como padrão 4096.
WS_XML_READER_PROPERTY_IN_ATTRIBUTE
Valor: 9
Indica que WsReadStartAttribute foi chamado e o leitor é
posicionado no conteúdo do atributo.
WS_XML_READER_PROPERTY_STREAM_MAX_ROOT_MIME_PART_SIZE
Valor: 10
Um ULONG usado com WS_XML_READER_STREAM_INPUT em conjunto com WS_XML_READER_MTOM_ENCODING.
Esse valor especifica o tamanho máximo da parte raiz do MIME, que é a parte que contém
a parte xml do documento. Ele não tem efeito quando usado com outras codificações ou quando usado com
WS_XML_READER_BUFFER_INPUT.


Essa propriedade usa como padrão 65536.
WS_XML_READER_PROPERTY_STREAM_MAX_MIME_HEADERS_SIZE
Valor: 11
Um ULONG usado com WS_XML_READER_STREAM_INPUT em conjunto com WS_XML_READER_MTOM_ENCODING.
Esse valor especifica o tamanho máximo de qualquer grupo de cabeçalhos MIME que podem aparecer no documento.
Ele não tem efeito quando usado com outras codificações ou quando usado com WS_XML_READER_BUFFER_INPUT.


Essa propriedade usa como padrão 256.
WS_XML_READER_PROPERTY_MAX_MIME_PARTS
Valor: 12
Um ULONG usado com WS_XML_READER_MTOM_ENCODING. Esse valor especifica o número máximo de partes MIME
que pode aparecer no documento. Ele não tem efeito quando usado com outras codificações.


Essa propriedade usa como padrão 4096.
WS_XML_READER_PROPERTY_ALLOW_INVALID_CHARACTER_REFERENCES
Valor: 13
Um BOOL usado com WS_XML_READER_TEXT_ENCODING. Definir isso como TRUE permite referências de caracteres
de caracteres considerados inválidos pelo XML 1.0 a serem aceitos.


Definir essa propriedade como TRUE pode afetar a interoperabilidade.


Essa propriedade usa como padrão FALSE.
WS_XML_READER_PROPERTY_MAX_NAMESPACES
Valor: 14
Um ULONG que especifica o número máximo de declarações exclusivas xmlns que podem aparecer no escopo a qualquer momento
ao ler o documento.


Essa propriedade usa como padrão 32.


Consulte WsCreateReader para obter considerações de segurança.

Requisitos

   
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