XmlTextReader.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 экземпляры с помощью XmlReader.Create метода, чтобы воспользоваться преимуществами новых функциональных возможностей.
Этот метод выполняет потоковую передачу содержимого, декодирует Base64
содержимое и возвращает декодированные двоичные байты (например, встроенное Base64
изображение GIF в кодировке) в буфер. Этот метод можно вызывать последовательно для чтения больших потоков внедренного текста. Дополнительные сведения см. в rfC 1521, "MIME (многоцелевых расширений электронной почты) Часть 1. Механизмы указания и описания формата текста сообщений Интернета". RfCs можно получить на веб-сайте запроса комментариев.
Примечание
Не следует обращаться к каким-либо свойствам чтения между вызовами ReadContentAsBase64 метода, пока метод не вернет значение 0.
Этот метод имеет следующее поведение:
ReadContentAsBase64 возвращает значение 0, когда оно достигло конца потока байтов, с которым он работал. Средство чтения размещается на первом узле, отличном от содержимого.
Если вы запрашиваете меньшее или точное число байтов, чем осталось в потоке, средство чтения остается в его текущей позиции.
ReadContentAsBase64не поддерживается в следующих типах УЗЛОВ XML:
Element
,XmlDeclaration
,None
,Document
,DocumentType
,Notation
.Entity``DocumentFragment