XmlReader.ReadContentAsBinHex(Byte[], Int32, Int32) Метод
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Считывает содержимое и возвращает раскодированные двоичные байты BinHex
.
public:
virtual int ReadContentAsBinHex(cli::array <System::Byte> ^ buffer, int index, int count);
public virtual int ReadContentAsBinHex (byte[] buffer, int index, int count);
abstract member ReadContentAsBinHex : byte[] * int * int -> int
override this.ReadContentAsBinHex : byte[] * int * int -> int
Public Overridable Function ReadContentAsBinHex (buffer As Byte(), index As Integer, count As Integer) As Integer
- buffer
- Byte[]
Буфер, в который копируется полученный текст. Это значение не может быть равно null
.
- index
- Int32
Смещение в буфере, с которого следует начать копировать результат.
- count
- 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.