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