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

Определение

Пространство имен:
System.Xml
Сборки:
System.Xml.dll, System.Xml.ReaderWriter.dll
Сборки:
netstandard.dll, System.Xml.ReaderWriter.dll
Сборка:
System.Xml.ReaderWriter.dll
Сборка:
System.Xml.dll
Сборка:
netstandard.dll
Исходный код:
XmlReader.cs
Исходный код:
XmlReader.cs
Исходный код:
XmlReader.cs
Исходный код:
XmlReader.cs
Исходный код:
XmlReader.cs

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

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

Параметры

buffer
Byte[]

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

index
Int32

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

count
Int32

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

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

Int32

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

Исключения

ArgumentNullException

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

InvalidOperationException

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

–или–

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

ArgumentOutOfRangeException

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

NotSupportedException

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

Комментарии

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

Note

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

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

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

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

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

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

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

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