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

定义

命名空间:

System.Xml

程序集:

System.Xml.ReaderWriter.dll

Source:

XmlTextReader.cs

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

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

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

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

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

参数

buffer

Byte[]

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

index

Int32

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

count

Int32

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

返回

Int32

写入缓冲区的字节数。

例外

ArgumentNullException

buffer 值为 null。

InvalidOperationException

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

ArgumentOutOfRangeException

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

NotSupportedException

XmlTextReader 实现不支持此方法。

注解

注意

从 .NET Framework 2.0 开始，建议使用 XmlReader.Create 方法创建XmlReader实例，以利用新功能。

此方法流式传输内容，解码 BinHex 内容，并返回解码的二进制字节 (例如，内联 BinHex 编码的 GIF 图像) 缓冲区。 可以连续调用此方法来读取大型嵌入文本流。

注意

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

此方法具有以下行为：

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

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

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

另请参阅

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