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

定义

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

写入缓冲区的字节数。

例外

buffer 值为 null

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

  • 或 -

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

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

XmlReader 实现不支持此方法。

注解

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

备注

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

此方法具有以下行为:

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

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

  • ReadContentAsBase64在以下 XML 节点类型上不受支持:Element、、None``XmlDeclarationDocumentDocumentTypeNotationEntity、 。 DocumentFragment

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

适用于

另请参阅