XmlValidatingReader.ReadElementContentAsBase64(Byte[], Int32, Int32) Метод

Определение

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

System.Xml

Сборки:

netstandard.dll, System.Xml.ReaderWriter.dll

Исходный код:

XmlValidatingReader.cs

Считывает элемент и декодирует содержимое 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 -> int

Public Overrides Function ReadElementContentAsBase64 (buffer As Byte(), index As Integer, count As Integer) As Integer

Параметры

buffer

Byte[]

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

index

Int32

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

count

Int32

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

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

Int32

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

Исключения

ArgumentNullException

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

InvalidOperationException

Текущий узел не является узлом элемента.

ArgumentOutOfRangeException

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

NotSupportedException

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

XmlException

Элемент содержит смешанное содержимое.

FormatException

Содержимое не может быть преобразовано в запрошенный тип.

Комментарии

Note

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

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

Этот метод может читать только простые элементы содержимого. Элемент может содержать текст, пробелы, значительные пробелы, разделы CDATA, комментарии и инструкции по обработке. Он также может содержать ссылки на сущности, которые автоматически развернуты. Элемент не может содержать дочерние элементы.

Этот метод очень похож на ReadContentAsBase64 метод, за исключением того, что его можно вызывать только в типах узлов элементов.

count Если значение выше числа байтов в документе или равно числу байтов в документе, XmlValidatingReader оно считывает все оставшиеся байты в документе и возвращает число байтов, считываемых в документе. XmlValidatingReader Следующий вызов метода возвращает ноль и перемещает читателя на узел после EndElement.

Если вы вызываете Read все содержимое элемента, средство чтения может вести себя так, как если бы использовалось первое содержимое, а затем Read был вызван метод. Это означает, что средство чтения считывает весь текст до тех пор, пока не будет обнаружен конечный элемент. Затем он считывает узел конечного тега, считывает следующий узел, а затем позиционирует себя на следующем последующем узле.

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

• XmlReader
• ReadContentAsBase64(Byte[], Int32, Int32)