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

Определение

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

System.Xml

Сборки:

netstandard.dll, System.Xml.ReaderWriter.dll

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

XmlReader.cs

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

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

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

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

Public Overridable 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

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

–или–

Метод XmlReader был вызван до завершения предыдущей асинхронной операции. В этом случае InvalidOperationException создается сообщение "Асинхронная операция уже выполняется".

ArgumentOutOfRangeException

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

NotSupportedException

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

XmlException

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

FormatException

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

Примеры

В следующем примере считывается встроенный BinHex кодированный образ. Данные BinHex внедрены в <image> элемент. Используется BinaryWriter для создания файла двоичных данных.

public static void BinHexDecodeImageFile() {

  byte[] buffer = new byte[1000];
  int readBytes = 0;

  using (XmlReader reader = XmlReader.Create("output.xml")) {
                    
        FileStream outputFile = new FileStream(@"C:\artFiles\data\newImage.jpg", FileMode.OpenOrCreate,
                                                                      FileAccess.Write, FileShare.Write);
        // Read to the image element.
        reader.ReadToFollowing("image");
        // Read the BinHex data.
        Console.WriteLine("\r\nReading BinHex...");
        BinaryWriter bw = new BinaryWriter(outputFile);
        while ((readBytes = reader.ReadElementContentAsBinHex(buffer, 0, 50))>0) {
            bw.Write(buffer, 0, readBytes);
        }
        outputFile.Close();
  }
}

Public Shared Sub BinHexDecodeImageFile() 
    
    Dim buffer(999) As Byte
    Dim readBytes As Integer = 0
    
    Using reader As XmlReader = XmlReader.Create("output.xml")
            
            Dim outputFile As New FileStream("C:\artFiles\data\newImage.jpg", FileMode.OpenOrCreate, FileAccess.Write, FileShare.Write)
            ' Read to the image element.
            reader.ReadToFollowing("image")
            ' Read the BinHex data.
            Console.WriteLine(vbCr + vbLf + "Reading BinHex...")
            Dim bw As New BinaryWriter(outputFile)
            readBytes = reader.ReadElementContentAsBinHex(buffer, 0, 50)
            While (readBytes > 0)
                bw.Write(buffer, 0, readBytes)
                readBytes = reader.ReadElementContentAsBinHex(buffer, 0, 50)
            End While
            outputFile.Close()
        
    End Using

End Sub

Комментарии

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

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

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

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

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

Сведения об асинхронной версии этого метода см. в разделе ReadElementContentAsBinHexAsync.

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

• ReadContentAsBinHex(Byte[], Int32, Int32)