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

定义

命名空间:

System.Xml

程序集:

System.Xml.dll

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

值为 buffernull.

InvalidOperationException

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

ArgumentOutOfRangeException

缓冲区或索引 + 计数中的索引大于分配的缓冲区大小。

NotSupportedException

实现 XmlValidatingReader 不支持此方法。

注解

注释

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

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

注释

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

此方法具有以下行为：

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

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

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

另请参阅

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