Поделиться через

перечисление WS_XML_READER_PROPERTY_ID (webservices.h)

  • Статья

Определяет каждое свойство средства чтения XML и связанное с ним значение. Это перечисление используется в структуре WS_XML_READER_PROPERTY , которая используется в качестве параметра для WsCreateReader, WsSetInput, WsSetInputToBuffer и WsReadXmlBufferFromBytes. Он также используется непосредственно в качестве параметра для WsGetReaderProperty.

Синтаксис

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;

Константы

 
WS_XML_READER_PROPERTY_MAX_DEPTH
Значение: 0
Значение ULONG, указывающее максимальную глубину документа, разрешенную средством чтения.


Глубина измеряется в любой точке по количеству вложенных начальных элементов.


Глубина 0 предотвращает чтение всех начальных элементов.


Это свойство по умолчанию — 32.


Рекомендации по обеспечению безопасности см. в статье WsCreateReader .
WS_XML_READER_PROPERTY_ALLOW_FRAGMENT
Значение: 1
ЛОГИЧЕСКОЕ ЗНАЧЕНИЕ, которое
указывает, будет ли средство чтения разрешать несколько элементов и непустых пробелов на верхнем уровне документа. Это свойство
Для WS_XML_READER_MTOM_ENCODING может не быть задано значение TRUE.


Это свойство по умолчанию имеет значение FALSE.
WS_XML_READER_PROPERTY_MAX_ATTRIBUTES
Значение: 2
Значение ULONG, указывающее максимальное количество атрибутов, разрешенных средством чтения для элемента.


Это свойство по умолчанию — 128.


Рекомендации по обеспечению безопасности см. в статье WsCreateReader .
WS_XML_READER_PROPERTY_READ_DECLARATION
Значение: 3
Значение ТИПА BOOL, указывающее, должно ли средство чтения разрешать объявление xml в начале документа.


Это свойство по умолчанию имеет значение TRUE.
WS_XML_READER_PROPERTY_CHARSET
Значение: 4
Значение WS_CHARSET , возвращающее набор символов xml-документа. Это значение доступно только для
текстовые документы.


Если средство чтения было инициализировано с помощью WS_CHARSET_AUTO оно автоматически определит это.
альфа. Источник входных данных чтения передается в потоковую передачу, после чего читатель должен иметь достаточно данных в буфере, чтобы иметь возможность
проверьте начальные метки порядка байтов и объявление XML. См . раздел WsFillReader.


Если средство чтения было инициализировано любым другим значением, это свойство просто возвращает это значение.
WS_XML_READER_PROPERTY_ROW
Значение: 5
Объект ULONGLONG, возвращающий номер строки на основе 0 узла, на который размещается средство чтения для текстовых XML-документов.
WS_XML_READER_PROPERTY_COLUMN
Значение: 6
ULONGLONG, возвращающий номер столбца на основе 0 узла, на который размещается средство чтения для текстовых xml-документов.
WS_XML_READER_PROPERTY_UTF8_TRIM_SIZE
Значение: 7
ULONG, указывающий размер обрезки внутреннего буфера, используемого
WS_XML_READER для преобразования UTF-16 в UTF-8. Увеличение этого значения
использует больше памяти, но может уменьшить выделение при обработке документов в кодировке UTF-16.


Это свойство по умолчанию — 4096.
WS_XML_READER_PROPERTY_STREAM_BUFFER_SIZE
Значение: 8
ULONG, указывающий размер буфера, который будет использоваться WS_XML_READER при настройке для использования.
WS_XML_READER_STREAM_INPUT. При увеличении этого значения используется больше памяти, но
может уменьшить количество вызовов WS_READ_CALLBACK .


Это свойство по умолчанию — 4096.
WS_XML_READER_PROPERTY_IN_ATTRIBUTE
Значение: 9
Указывает, что метод WsReadStartAttribute был вызван, а средство чтения —
позиционируется в содержимом атрибута.
WS_XML_READER_PROPERTY_STREAM_MAX_ROOT_MIME_PART_SIZE
Значение: 10
ULONG, используемый с WS_XML_READER_STREAM_INPUT в сочетании с WS_XML_READER_MTOM_ENCODING.
Это значение указывает максимальный размер корневой части MIME, которая является частью, содержащей
xml-часть документа. Она не оказывает никакого влияния при использовании с другими кодировками или при использовании с
WS_XML_READER_BUFFER_INPUT.


Это свойство по умолчанию — 65536.
WS_XML_READER_PROPERTY_STREAM_MAX_MIME_HEADERS_SIZE
Значение: 11
ULONG, используемый с WS_XML_READER_STREAM_INPUT в сочетании с WS_XML_READER_MTOM_ENCODING.
Это значение указывает максимальный размер любой группы заголовков MIME, которые могут отображаться в документе.
Она не оказывает никакого влияния при использовании с другими кодировками или при использовании с WS_XML_READER_BUFFER_INPUT.


Это свойство по умолчанию — 256.
WS_XML_READER_PROPERTY_MAX_MIME_PARTS
Значение: 12
ULONG, используемый с WS_XML_READER_MTOM_ENCODING. Это значение указывает максимальное число частей MIME.
значение , которое может отображаться в документе. Она не оказывает никакого влияния при использовании с другими кодировками.


Это свойство по умолчанию — 4096.
WS_XML_READER_PROPERTY_ALLOW_INVALID_CHARACTER_REFERENCES
Значение: 13
ЛОГИЧЕСКОЕ ЗНАЧЕНИЕ, используемое с WS_XML_READER_TEXT_ENCODING. Если задать значение TRUE , ссылки на символы разрешены.
символов, которые считаются недопустимыми в XML 1.0 для принятия.


Установка для этого свойства значения TRUE может повлиять на взаимодействие.


Это свойство по умолчанию имеет значение FALSE.
WS_XML_READER_PROPERTY_MAX_NAMESPACES
Значение: 14
ULONG, указывающее максимальное число уникальных объявлений xmlns, которые могут отображаться в область в любой момент.
при чтении документа.


Это свойство по умолчанию — 32.


Рекомендации по обеспечению безопасности см. в статье WsCreateReader .

Требования

   
Минимальная версия клиента Windows 7 [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 R2 [классические приложения | Приложения UWP]
Верхняя часть webservices.h