Поделиться через


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

Определение

Считывает элемент и декодирует его из кодировки 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

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

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

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

Исключения

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

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

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

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

Не удается преобразовать содержимое в требуемый тип.

Примеры

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

Комментарии

Примечание

В платформа .NET Framework 2.0 рекомендуется создавать XmlReader экземпляры с помощью XmlReaderSettings класса и Create метода . Это позволяет в полной мере воспользоваться всеми новыми функциями, представленными в платформа .NET Framework. Дополнительные сведения см. в разделе Примечания на справочной XmlReader странице.

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

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

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

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

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

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

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