通过

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

  • 参考

定义

命名空间:
System.Xml
程序集:
System.Xml.ReaderWriter.dll
程序集:
System.Xml.dll
程序集:
netstandard.dll

读取内容并返回 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 开始，我们建议使用XmlReader.Create该方法来利用新功能来创建XmlReader实例。

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

备注

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

此方法具有以下行为：

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

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

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

适用于

另请参阅