XmlNodeReader.ReadElementContentAsBinHex(Byte[], Int32, Int32) 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
讀取項目，並將 BinHex 內容解碼。
public:
override int ReadElementContentAsBinHex(cli::array <System::Byte> ^ buffer, int index, int count);public override int ReadElementContentAsBinHex (byte[] buffer, int index, int count);override this.ReadElementContentAsBinHex : byte[] * int * int -> intPublic Overrides Function ReadElementContentAsBinHex (buffer As Byte(), index As Integer, count As Integer) As Integer參數
- buffer
- Byte[]
將產生的文字複製到其中的緩衝區。 這個值不能是 null。
- index
- Int32
緩衝區中開始複製結果的位移。
- count
- Int32
要複製至緩衝區中的最大位元組數目。 從這個方法傳回所複製的實際位元組數目。
傳回
寫入緩衝區的位元組數目。
例外狀況
buffer 值為 null。
目前的節點不是項目節點。
緩衝區的索引或是索引 + 計數大於所配置的緩衝區大小。
項目包含混合內容。
內容無法轉換成要求的類型。
範例
請參閱 XmlReader.ReadElementContentAsBinHex 以查看使用此方法的範例。
備註
注意
在 .NET Framework 2.0 中，建議的做法是使用 XmlReaderSettings 類別和 Create 方法建立 XmlReader 實例。 這可讓您充分利用.NET Framework中引進的所有新功能。 如需詳細資訊，請參閱參考頁面中的 XmlReader 一節。
這個方法會讀取元素內容、使用 BinHex 編碼進行解碼，並將解碼的二進位位元組傳回 (例如，內嵌 BinHex 編碼 GIF 影像) 緩衝區。
這個方法只能讀取簡單內容元素。 元素可以包含文字、空白字元、重大空白字元、CDATA 區段、批註和處理指示。 它也可以包含會自動展開的實體參考。 專案不能有子專案。
這個方法與 方法非常類似 ReadContentAsBinHex ，不同之處在于它只能在元素節點類型上呼叫。
如果計數值高於檔中的位元組數目，或等於檔中的位元組數目，則會 XmlNodeReader 讀取檔中的所有剩餘位元組，並傳回讀取的位元組數。 下一 XmlNodeReader 個方法呼叫會傳回零，並將讀取器移至節點後面的 EndElement 節點。
如果您在取用所有元素內容之前呼叫 Read ，則讀取器的行為可能會像取用第一個內容，然後 Read 呼叫 方法一樣。 這表示讀取器會讀取所有文字，直到遇到 end 元素為止。 然後它會讀取結束標籤節點、讀取下一個節點，然後將本身放在下一個後續節點上。