共用方式為


XmlNodeReader.ReadContentAsBase64(Byte[], Int32, Int32) 方法

定義

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

public:
 override int ReadContentAsBase64(cli::array <System::Byte> ^ buffer, int index, int count);
public override int ReadContentAsBase64 (byte[] buffer, int index, int count);
override this.ReadContentAsBase64 : byte[] * int * int -> int
Public Overrides Function ReadContentAsBase64 (buffer As Byte(), index As Integer, count As Integer) As Integer

參數

buffer
Byte[]

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

index
Int32

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

count
Int32

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

傳回

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

例外狀況

buffer 值為 null

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

備註

注意

在 .NET Framework 2.0 中,建議的做法是使用 XmlReaderSettings 類別和 Create 方法建立 XmlReader 實例。 這可讓您充分利用.NET Framework中引進的所有新功能。 如需詳細資訊,請參閱參考頁面中的一 XmlReader 節。

這個方法會串流處理內容、解碼 Base64 內容,並將解碼的二進位位元組傳回 (,例如,內嵌 Base64 編碼的 GIF 影像) 至緩衝區。 您可以連續呼叫這個方法,以讀取大型內嵌文字資料流程。 如需詳細資訊,請參閱 RFC 1521:「MIME (多用途網際網路郵件延伸模組) 第一部分:指定及描述網際網路訊息本文格式的機制」。 您可以從 [批註要求] 網站取得 RFC。

注意

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

這個方法具有下列行為:

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

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

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

適用於

另請參閱