System.Xml.XmlNodeReader.ReadContentAsBase64 方法

方法描述

读取内容并返回 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。

System.Xml.XmlNodeReader.ReadContentAsBase64 方法例子


异常

异常 异常描述
ArgumentNullException buffer 值为 null。
InvalidOperationException 当前节点不支持 ReadContentAsBase64。
ArgumentOutOfRangeException 缓冲区中的索引或者索引与计数之和大于分配的缓冲区大小。

命名空间

namespace: System.Xml

程序集: System.Xml(在 System.Xml.dll 中)

版本信息

.NET Framework 受以下版本支持:4、3.5、3.0、2.0 .NET Framework Client Profile 受以下版本支持:4、3.5 SP1

适用平台

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求。