XmlTextReader.ReadContentAsBinHex(Byte[], Int32, Int32) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Считывает содержимое и возвращает раскодированные двоичные байты BinHex.
public:
override int ReadContentAsBinHex(cli::array <System::Byte> ^ buffer, int index, int count);public override int ReadContentAsBinHex(byte[] buffer, int index, int count);override this.ReadContentAsBinHex : byte[] * int * int -> intPublic Overrides 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) не поддерживается на текущем узле.
Значение индекса в буфере или сумма значений индекса и счетчика больше, чем выделенный размер буфера.
Реализация XmlTextReader не поддерживает данный метод.
Примечание
Начиная с платформа .NET Framework 2.0 рекомендуется создавать XmlReader экземпляры с помощью XmlReader.Create метода , чтобы воспользоваться преимуществами новых функций.
Этот метод выполняет потоковую передачу содержимого, декодирует BinHex его и возвращает декодированные двоичные байты (например, встроенное BinHex закодированное ИЗОБРАЖЕНИЕ GIF) в буфер. Этот метод можно вызывать последовательно для чтения больших потоков внедренного текста.
Примечание
Не следует обращаться к свойствам средства чтения между вызовами метода, ReadContentAsBinHex пока метод не вернет значение 0.
Этот метод имеет следующее поведение:
ReadContentAsBinHex возвращает значение 0, когда оно достигло конца потока байтов, с которым он работал. Средство чтения размещается на первом узле, не являющемся содержимым.
Если вы запрашиваете меньшее или точное количество байтов, чем осталось в потоке, средство чтения остается в текущей позиции.
ReadContentAsBinHexне поддерживается для следующих типов узлов XML:
Element,XmlDeclaration,None,Document,DocumentType,Notation,Entity.DocumentFragment
Применяется к
| Продукт | Версии |
|---|---|
| .NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10 |
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
