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

Определение

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

System.Xml

Сборка:

System.Xml.ReaderWriter.dll

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

XmlNodeReader.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

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

XmlException

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

FormatException

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

Примеры

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

Комментарии

Примечание

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

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

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

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

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

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

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

• ReadContentAsBinHex(Byte[], Int32, Int32)
• ReadElementContentAsBase64(Byte[], Int32, Int32)