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

  • Ссылка

Определение

Пространство имен:
System.Xml
Сборка:
System.Xml.ReaderWriter.dll
Сборка:
System.Xml.dll
Сборка:
netstandard.dll

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

Комментарии

Примечание

Начиная с версии платформа .NET Framework 2.0 рекомендуется создавать XmlReader экземпляры с помощью XmlReader.Create метода, чтобы воспользоваться преимуществами новых функциональных возможностей.

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

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

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

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

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

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

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