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 был вызван метод . Это означает, что средство чтения считывает весь текст до тех пор, пока не будет обнаружен конечный элемент. Затем он считывает узел конечного тега, считывает следующий узел и позиционирует себя на следующем последующем узле.