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


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

Определение

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

public:
 override int ReadContentAsBase64(cli::array <System::Byte> ^ buffer, int index, int count);
public override int ReadContentAsBase64 (byte[] buffer, int index, int count);
override this.ReadContentAsBase64 : byte[] * int * int -> int
Public Overrides Function ReadContentAsBase64 (buffer As Byte(), index As Integer, count As Integer) As Integer

Параметры

buffer
Byte[]

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

index
Int32

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

count
Int32

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

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

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

Исключения

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

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

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

Комментарии

Примечание

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

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

Примечание

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

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

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

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

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

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

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