XmlValidatingReader.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

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

注解

备注

类XmlValidatingReader在 .NET Framework 2.0 中已过时。 可以使用类和Create方法创建验证XmlReader实例XmlReaderSettings。 有关详细信息，请参阅 XmlReader 引用页的“备注”部分。

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

备注

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

此方法具有以下行为：

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

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

• ReadContentAsBase64 在以下 XML 节点类型上不受支持：元素、XmlDeclaration、None、Document、DocumentType、表示法、实体和 DocumentFragment。

另请参阅

• XmlReader
• ReadElementContentAsBase64(Byte[], Int32, Int32)
• XmlNodeType