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

Определение

Пространство имен:

System.Xml

Сборки:

netstandard.dll, System.Xml.ReaderWriter.dll

Исходный код:

XmlTextReader.cs

Считывает содержимое и возвращает декодированные двоичные 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 -> int

Public Overrides Function ReadContentAsBinHex (buffer As Byte(), index As Integer, count As Integer) As Integer

Параметры

buffer

Byte[]

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

index

Int32

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

count

Int32

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

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

Int32

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

Исключения

ArgumentNullException

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

InvalidOperationException

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

ArgumentOutOfRangeException

Индекс в буфер или индекс + число больше выделенного размера буфера.

NotSupportedException

Реализация XmlTextReader не поддерживает этот метод.

Комментарии

Note

Рекомендуем создавать XmlReader экземпляры с помощью XmlReader.Create метода, чтобы воспользоваться новыми функциями.

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

Note

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

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

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

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

• ReadContentAsBinHexне поддерживается в следующих типах XML-узлов: Element, XmlDeclaration, None, Document, DocumentType, Notation. EntityDocumentFragment

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

• XmlReader
• ReadElementContentAsBinHex(Byte[], Int32, Int32)
• XmlNodeType