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

定義

讀取內容,並傳回 BinHex 已解碼的二進位位元組。

C#
public virtual int ReadContentAsBinHex (byte[] buffer, int index, int count);

參數

buffer
Byte[]

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

index
Int32

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

count
Int32

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

傳回

Int32

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

例外狀況

buffer 值為 null

目前的節點不支援 ReadContentAsBinHex(Byte[], Int32, Int32)

-或-

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

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

XmlReader 實作不支援這個方法。

備註

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

備註

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

這個方法具有下列行為:

  • ReadContentAsBinHex 傳回值 0 ,當它已到達其正在操作的位元組資料流程結尾時。 讀取器位於第一個非內容節點上。

  • 如果您要求的位元組數目少於或確切數目,則讀取器會保留在資料流程中的目前位置。

  • ReadContentAsBinHex 下列 XML 節點類型不支援: Element 、、 XmlDeclarationNoneDocumentDocumentTypeNotation, Entity DocumentFragment

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

適用於

產品 版本
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

另請參閱