XmlReader.ReadContentAsBinHex(Byte[], Int32, Int32) 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
读取内容并返回 BinHex 解码的二进制字节。
public:
virtual int ReadContentAsBinHex(cli::array <System::Byte> ^ buffer, int index, int count);public virtual int ReadContentAsBinHex (byte[] buffer, int index, int count);abstract member ReadContentAsBinHex : byte[] * int * int -> int
override this.ReadContentAsBinHex : byte[] * int * int -> intPublic Overridable Function ReadContentAsBinHex (buffer As Byte(), index As Integer, count As Integer) As Integer参数
- buffer
- Byte[]
结果文本复制到的缓冲区。 此值不能为 null。
- index
- Int32
缓冲区中的偏移，从这个位置开始将结果复制到缓冲区中。
- count
- Int32
要复制到缓冲区的最大字节数。 此方法返回复制的实际字节数。
返回
写入缓冲区的字节数。
例外
buffer 值为 null。
当前节点不支持 ReadContentAsBinHex(Byte[], Int32, Int32)。
- 或 -
在上一次异步操作完成之前调用了 XmlReader 方法。 在此情况下，会引发 InvalidOperationException 并显示消息“异步操作已在进行中。”
缓冲区中的索引或者索引与计数之和大于分配的缓冲区大小。
XmlReader 实现不支持此方法。
注解
此方法流式传输内容、解码 BinHex 内容，并返回解码的二进制字节 (，例如，内联 BinHex 编码的 GIF 图像) 缓冲区。 可以连续调用此方法以读取大量嵌入文本流。
备注
在方法返回值0之前，不应在调用ReadContentAsBinHex方法之间访问任何读取器属性。
此方法具有以下行为：
ReadContentAsBinHex 当它已到达其所操作的字节流的末尾时，返回该值
0。 读取器位于第一个非内容节点上。如果请求的字节数少于或确切的字节数，则读取器将保留在其当前位置。
ReadContentAsBinHex在以下 XML 节点类型上不受支持：
Element、、None``XmlDeclaration、Document、DocumentType、、 。Notation, Entity``DocumentFragment
有关此方法的异步版本，请参阅 ReadContentAsBinHexAsync。