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

定义

命名空间:

System.Xml

程序集:

System.Xml.ReaderWriter.dll

Source:

XmlNodeReader.cs

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

public:
 override int ReadContentAsBase64(cli::array <System::Byte> ^ buffer, int index, int count);

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

override this.ReadContentAsBase64 : byte[] * int * int -> int

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

参数

buffer

Byte[]

结果文本复制到的缓冲区。 此值不能为 null。

index

Int32

缓冲区中的偏移，从这个位置开始将结果复制到缓冲区中。

count

Int32

要复制到缓冲区的最大字节数。 此方法返回复制的实际字节数。

返回

Int32

写入缓冲区的字节数。

例外

ArgumentNullException

buffer 值为 null。

InvalidOperationException

当前节点不支持 ReadContentAsBase64(Byte[], Int32, Int32)。

ArgumentOutOfRangeException

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

注解

注意

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

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

注意

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

此方法具有以下行为：

• ReadContentAsBase64 当它到达其操作的字节流的末尾时，返回值 0。 读取器位于第一个非内容节点上。

• 如果请求的字节数少于流中剩余的字节数或确切字节数，则读取器将保留其当前位置。

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

另请参阅

• ReadElementContentAsBase64(Byte[], Int32, Int32)
• ReadContentAsBinHex(Byte[], Int32, Int32)