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

定義

命名空間:

System.Xml

組件:

System.Xml.ReaderWriter.dll

來源:

XmlValidatingReader.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

XmlValidatingReader 實作不支援這個方法。

備註

注意

類別 XmlValidatingReader 在 .NET Framework 2.0 中已過時。 您可以使用 類別和 Create 方法建立驗證 XmlReader 實例 XmlReaderSettings 。 如需詳細資訊，請參閱 XmlReader 參考頁面的＜備註＞一節。

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

注意

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

這個方法具有下列行為：

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

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

• ReadContentAsBinHex 下列 XML 節點類型不支援：Element、XmlDeclaration、None、Document、DocumentType、Notation、Entity 和 DocumentFragment。

另請參閱

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