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

Определение

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

System.Xml

Сборка:

System.Xml.ReaderWriter.dll

Сборка:

System.Xml.dll

Сборка:

netstandard.dll

Считывает содержимое и возвращает раскодированные двоичные байты 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 (многоцелевых расширений электронной почты) Часть 1. Механизмы указания и описания формата текста сообщений Интернета". RfCs можно получить на веб-сайте "Запрос комментариев".

Примечание

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

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

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

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

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

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

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

• ReadElementContentAsBase64(Byte[], Int32, Int32)
• XmlNodeType