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

  • 参考

定义

命名空间:
System.Xml
程序集:
System.Xml.ReaderWriter.dll
程序集:
System.Xml.dll
程序集:
netstandard.dll
Source:
XmlNodeReader.cs
Source:
XmlNodeReader.cs
Source:
XmlNodeReader.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

缓冲区中的索引或者索引与计数之和大于分配的缓冲区大小。

XmlException

该元素包含混合内容。

FormatException

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

示例

请参阅 XmlReader.ReadElementContentAsBase64 查看使用此方法的示例。

注解

注意

在 .NET Framework 2.0 中，建议的做法是使用 XmlReaderSettings 类和 Create 方法创建XmlReader实例。 这使你可以充分利用.NET Framework中引入的所有新功能。 有关详细信息，请参阅参考页中的 XmlReader “备注”部分。

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

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

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

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

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

适用于

另请参阅