XmlValidatingReader.ReadElementContentAsBase64(Byte[], Int32, Int32) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Считывает элемент и декодирует его из кодировки Base64.
public:
override int ReadElementContentAsBase64(cli::array <System::Byte> ^ buffer, int index, int count);public override int ReadElementContentAsBase64 (byte[] buffer, int index, int count);override this.ReadElementContentAsBase64 : byte[] * int * int -> intPublic Overrides Function ReadElementContentAsBase64 (buffer As Byte(), index As Integer, count As Integer) As IntegerПараметры
- buffer
- Byte[]
Буфер, в который копируется полученный текст. Это значение не может быть равно null.
- index
- Int32
Смещение в буфере, с которого следует начать копировать результат.
- count
- Int32
Максимальное количество копируемых в буфер байтов. Этот метод возвращает фактическое количество скопированных байтов.
Возвращаемое значение
Количество байтов, записанных в буфер.
Исключения
Значение buffer равно null.
Текущий узел не является узлом элемента.
Значение индекса в буфере или сумма значений индекса и счетчика больше, чем выделенный размер буфера.
Реализация XmlValidatingReader не поддерживает данный метод.
Элемент содержит смешанное содержимое.
Не удается преобразовать содержимое в требуемый тип.
Комментарии
Примечание
Класс XmlValidatingReader устарел в платформа .NET Framework 2.0. Проверяющий XmlReader экземпляр можно создать с помощью XmlReaderSettings класса и Create метода. Дополнительные сведения см. в подразделе "Примечания" на справочной странице XmlReader.
Этот метод считывает содержимое элемента, декодирует его с помощью кодировки Base64 и возвращает декодированные двоичные байты (например, встроенное изображение GIF в кодировке Base64) в буфер. Дополнительные сведения см. в документе RFC 1521, "MIME (многоцеловые расширения электронной почты) Часть 1. Механизмы указания и описания формата текста сообщений Интернета". RfC можно получить на веб-сайте "Запрос комментариев".
Этот метод может считывать только простые элементы содержимого. Элемент может содержать текст, пробелы, значительные пробелы, разделы CDATA, комментарии и инструкции по обработке. Он также может содержать ссылки на сущности, которые автоматически разворачиваются. Элемент не может содержать дочерние элементы.
Этот метод очень похож на ReadContentAsBase64 метод, за исключением того, что его можно вызывать только в типах узлов элементов.
count Если значение превышает число байтов в документе или равно числу байтов в документе, XmlValidatingReader то он считывает все оставшиеся байты в документе и возвращает число прочитанных байтов. Следующий XmlValidatingReader вызов метода возвращает ноль и перемещает средство чтения на узел после EndElement.
При вызове Read до использования всего содержимого элемента средство чтения может вести себя так, как если бы первое содержимое было занято, а затем Read был вызван метод. Это означает, что средство чтения будет считывать весь текст до тех пор, пока не будет обнаружен конечный элемент. Затем он считывает узел конечного тега, считывает следующий узел, а затем позиционирует себя на следующем последующем узле.