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

Определение

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

System.Xml

Сборки:

netstandard.dll, System.Xml.ReaderWriter.dll

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

XmlTextReader.cs

Считывает элемент и декодирует содержимое BinHex .

public:
 override int ReadElementContentAsBinHex(cli::array <System::Byte> ^ buffer, int index, int count);

public override int ReadElementContentAsBinHex(byte[] buffer, int index, int count);

override this.ReadElementContentAsBinHex : byte[] * int * int -> int

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

Параметры

buffer

Byte[]

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

index

Int32

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

count

Int32

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

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

Int32

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

Исключения

ArgumentNullException

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

InvalidOperationException

Текущий узел не является узлом элемента.

ArgumentOutOfRangeException

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

NotSupportedException

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

XmlException

Элемент содержит смешанное содержимое.

FormatException

Содержимое не может быть преобразовано в запрошенный тип.

Примеры

Ознакомьтесь XmlReader.ReadElementContentAsBinHex с примером использования этого метода.

Комментарии

Note

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

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

Этот метод может читать только элементы простого содержимого. Элемент может содержать текст, пробелы, значительные пробелы, разделы CDATA, комментарии и инструкции по обработке. Он также может содержать ссылки на сущности, которые автоматически развернуты. Элемент не может содержать дочерние элементы.

Этот метод очень похож на ReadContentAsBinHex метод, за исключением того, что его можно вызывать только в типах узлов элементов.

count Если значение выше числа байтов в документе или равно числу байтов в документе, XmlTextReader оно считывает все оставшиеся байты в документе и возвращает число байтов, считываемых в документе. XmlTextReader Следующий вызов метода возвращает ноль и перемещает читателя на узел после EndElement.

Если вы вызываете Read все содержимое элемента, средство чтения может вести себя так, как если бы использовалось первое содержимое, а затем Read был вызван метод. Это означает, что средство чтения считывает весь текст до тех пор, пока не будет обнаружен конечный элемент. Затем он считывает узел конечного тега, считывает следующий узел, а затем позиционирует себя на следующем последующем узле.

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

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