XmlReader.ReadContentAsBinHex(Byte[], Int32, Int32) Метод

Определение

Считывает содержимое и возвращает раскодированные двоичные байты BinHex.

public virtual int ReadContentAsBinHex (byte[] buffer, int index, int count);

Параметры

buffer
Byte[]

Буфер, в который копируется полученный текст. Это значение не может быть равно null.

index
Int32

Смещение в буфере, с которого следует начать копировать результат.

count
Int32

Максимальное количество копируемых в буфер байтов. Этот метод возвращает фактическое количество скопированных байтов.

Возвращаемое значение

Int32

Количество байтов, записанных в буфер.

Исключения

Значение buffer равно null.

Метод ReadContentAsBinHex(Byte[], Int32, Int32) не поддерживается на текущем узле.

-или-

Метод XmlReader вызван перед завершением предыдущей асинхронной операции. В этом случае возникает исключение InvalidOperationException с сообщением "Асинхронная операция уже выполняется".

Значение индекса в буфере или сумма значений индекса и счетчика больше, чем выделенный размер буфера.

Реализация XmlReader не поддерживает данный метод.

Комментарии

Этот метод передает содержимое, декодирует BinHex содержимое и возвращает декодированные двоичные байты (например, встроенное BinHex изображение GIF) в буфер. Этот метод можно вызывать последовательно для чтения больших потоков внедренного текста.

Ескерім

Не следует обращаться к каким-либо свойствам чтения между вызовами ReadContentAsBinHex метода, пока метод не вернет значение 0.

Этот метод имеет следующее поведение:

  • ReadContentAsBinHex возвращает значение 0 , когда оно достигло конца потока байтов, с которым он работал. Средство чтения размещается на первом узле, отличном от содержимого.

  • Если вы запрашиваете меньшее или точное число байтов, чем осталось в потоке, средство чтения остается в его текущей позиции.

  • ReadContentAsBinHexне поддерживается в следующих типах УЗЛОВ XML: Element, XmlDeclaration, None, Document, DocumentType. Notation, Entity``DocumentFragment

Асинхронная версия этого метода см. в разделе ReadContentAsBinHexAsync.

Применяется к

См. также раздел