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

定義

命名空間:

System.Xml

組件:

System.Xml.ReaderWriter.dll

Source:

XmlNodeReader.cs

讀取內容，並傳回 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

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

傳回

Int32

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

例外狀況

ArgumentNullException

buffer 值為 null。

InvalidOperationException

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

ArgumentOutOfRangeException

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

備註

注意

在 .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。

另請參閱

• ReadElementContentAsBase64(Byte[], Int32, Int32)
• ReadContentAsBinHex(Byte[], Int32, Int32)