System.Xml.XmlNodeReader.ReadContentAsBase64 方法

上一篇：System.Xml.XmlNodeReader.ReadContentAs 方法下一篇：System.Xml.XmlNodeReader.ReadContentAsBinHex 方法

方法描述

读取内容并返回 Base64 解码的二进制字节。

语法定义(C# System.Xml.XmlNodeReader.ReadContentAsBase64 方法的用法)

public override int ReadContentAsBase64(
	byte[] buffer,
	int index,
	int count
)

参数/返回值

参数值/返回值	参数类型/返回类型	参数描述/返回描述
buffer	System-Byte[]	作为结果文本复制目标的缓冲区。此值不能为 null。
index	System-Int32	缓冲区中的偏移，从这个位置开始将结果复制到缓冲区中。
count	System-Int32	要复制到缓冲区的最大字节数。此方法返回复制的实际字节数。
返回值	System.Int32	写入缓冲区的字节数。

提示和注释

注意

在 .NET Framework 2.0 版中，推荐的做法是使用 XmlReaderSettings 类和 Create 方法创建 XmlReader 实例。这使您可以充分利用 .NET Framework 中引入的所有新功能。有关更多信息，请参见创建 XML 读取器。

此方法对内容进行流处理，对 Base64 内容进行解码并将解码的二进制字节（例如内联 Base64 编码的 GIF 图像）返回到缓冲区中。可以连续调用此方法以读取大的嵌入文本流。有关更多信息，请参见 RFC 1521“MIME (Multipurpose Internet Mail Extensions) Part One: Mechanisms for Specifying and Describing the Format of Internet Message Bodies”（多用途 Internet 邮件扩展 (MIME) 第一部分：指定和描述 Internet 邮件正文格式的机制）。可以从位于 http://www.rfc-editor.org 的“Request for Comments”（请求注释）网站获得 RFC。

注意

在 ReadContentAsBase64 方法返回值 0 之前，不应在两次调用该方法之间访问任何读取器属性。

此方法具有下面的行为：

如果 ReadContentAsBase64 到达了它正在操作的字节流的末尾，则返回值 0。该读取器定位在第一个非内容节点上。

如果您要求的字节数小于或等于流中剩余的字节数，则读取器将保留在当前位置。

下面的 XML 节点类型不支持 ReadContentAsBase64：Element、XmlDeclaration、None、Document、DocumentType、Notation、Entity 和 DocumentFragment。