Прочитать на английском

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


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

Определение

Считывает содержимое и возвращает раскодированные двоичные байты Base64.

public override int ReadContentAsBase64 (byte[] buffer, int index, int count);

Параметры

buffer
Byte[]

Буфер, в который копируется полученный текст. Это значение не может быть равно null.

index
Int32

Смещение в буфере, с которого следует начать копировать результат.

count
Int32

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

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

Int32

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

Исключения

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

Метод ReadContentAsBase64(Byte[], Int32, Int32) не поддерживается в текущем узле.

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

Комментарии

Примечание

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

Этот метод выполняет потоковую передачу содержимого, декодирует Base64 содержимое и возвращает декодированные двоичные байты (например, встроенное Base64изображение GIF в кодировке) в буфер. Этот метод можно вызывать последовательно для чтения больших потоков внедренного текста. Дополнительные сведения см. в rfC 1521, "MIME (многоцелевых расширений электронной почты) Часть 1. Механизмы указания и описания формата текста сообщений Интернета". RfCs можно получить на веб-сайте запроса комментариев.

Примечание

Не следует обращаться к каким-либо свойствам чтения между вызовами ReadContentAsBase64 метода, пока метод не вернет значение 0.

Этот метод имеет следующее поведение:

  • ReadContentAsBase64 возвращает значение 0, когда оно достигло конца потока байтов, с которым он работал. Средство чтения размещается на первом узле, отличном от содержимого.

  • Если вы запрашиваете меньшее или точное число байтов, чем осталось в потоке, средство чтения остается в его текущей позиции.

  • ReadContentAsBase64не поддерживается в следующих типах УЗЛОВ XML: Element, XmlDeclaration, None, Document, DocumentType, Notation. Entity``DocumentFragment

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

Продукт Версии
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 2.0, 2.1

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