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 -> int

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

將產生的文字複製到其中的緩衝區。這個值不能是 null。

緩衝區中開始複製結果的位移。

要複製至緩衝區中的最大位元組數目。從這個方法傳回所複製的實際位元組數目。

寫入緩衝區的位元組數目。

buffer 值為 null。

-或-

在先前的非同步作業完成前呼叫了 XmlReader 方法。在此情況下，會擲回 InvalidOperationException 與「非同步作業已經在進行中」的訊息。

緩衝區的索引或是索引 + 計數大於所配置的緩衝區大小。

XmlReader 實作不支援這個方法。

這個方法會串流內容、解碼 BinHex 內容，並將解碼的二進位位元組傳回 (例如，將內嵌 BinHex 編碼的 GIF 影像) 到緩衝區。您可以連續呼叫這個方法，以讀取內嵌文字的大型資料流程。

注意

在方法傳回值 0 之前，您不應該在呼叫 ReadContentAsBinHex 方法之間存取任何讀取器屬性。

這個方法具有下列行為：

ReadContentAsBinHex 傳回值 0 ，當它已到達其正在操作的位元組資料流程結尾時。讀取器位於第一個非內容節點上。
如果您要求的位元組數目少於或確切數目，則讀取器會保留在資料流程中的目前位置。
ReadContentAsBinHex 下列 XML 節點類型不支援： Element 、、 XmlDeclaration 、 None 、 Document 、 DocumentType 、 Notation, Entity DocumentFragment 。

如需這個方法的非同步版本，請參閱 ReadContentAsBinHexAsync 。