通过

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

  • 参考

定义

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

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

public:
 virtual int ReadContentAsBase64(cli::array <System::Byte> ^ buffer, int index, int count);
public virtual int ReadContentAsBase64 (byte[] buffer, int index, int count);
abstract member ReadContentAsBase64 : byte[] * int * int -> int
override this.ReadContentAsBase64 : byte[] * int * int -> int
Public Overridable 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)。

  • 或 -

在上一次异步操作完成之前调用了 XmlReader 方法。 在此情况下，会引发 InvalidOperationException 并显示消息“异步操作已在进行中。”

ArgumentOutOfRangeException

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

NotSupportedException

XmlReader 实现不支持此方法。

注解

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

备注

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

此方法具有以下行为：

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

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

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

有关此方法的异步版本，请参阅 ReadContentAsBase64Async。

适用于

另请参阅