XmlValidatingReader.ReadElementContentAsBase64(Byte[], Int32, Int32) 方法

定义

命名空间:

System.Xml

程序集:

System.Xml.ReaderWriter.dll

程序集:

System.Xml.dll

程序集:

netstandard.dll

读取元素并对 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

无法将内容转换成请求的类型。

注解

备注

类XmlValidatingReader在 .NET Framework 2.0 中已过时。 可以使用类和Create方法创建验证XmlReader实例XmlReaderSettings。 有关详细信息，请参阅 XmlReader 引用页的“备注”部分。

此方法读取元素内容，使用 Base64 编码对其进行解码，并返回解码的二进制字节 (例如内联 Base64 编码的 GIF 图像) 缓冲区。 有关详细信息，请参阅 RFC 1521“MIME (多用途 Internet 邮件扩展) 第一部分：指定和描述 Internet 邮件正文格式的机制”。 可以从 “注释请求”网站获取 RFC。

此方法只能读取简单内容元素。 该元素可以包含文本、空格、重大空白、CDATA 节、注释和处理指令。 它还可以包含自动展开的实体引用。 该元素不能有子元素。

此方法与该方法非常相似 ReadContentAsBase64 ，但只能在元素节点类型上调用此方法。

count如果该值高于文档中的字节数，或者如果该值等于文档中的字节数，则XmlValidatingReader读取文档中的所有剩余字节并返回读取的字节数。 下一 XmlValidatingReader 个方法调用返回零，并将读取器移动到后面的 EndElement节点。

如果在使用所有元素内容之前调用 Read ，则读取器的行为可能类似于使用第一个内容，然后 Read 调用了该方法。 这意味着读取器将读取所有文本，直到遇到结束元素。 然后，它将读取结束标记节点、读取下一个节点，然后将自身定位在下一个后续节点上。

另请参阅

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