XmlNodeReader.ReadContentAsBase64(Byte[], Int32, Int32) メソッド

定義

名前空間:
System.Xml
アセンブリ:
System.Xml.dll
アセンブリ:
netstandard.dll

コンテンツを読み取り、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

バッファーまたはインデックス + カウントへのインデックスが、割り当てられたバッファー サイズよりも大きい。

注釈

Note

新しい機能を利用するには、XmlReader クラスと XmlReaderSettings メソッドを使用してCreate インスタンスを作成することをお勧めします。 詳細については、「 XmlReader リファレンス」ページの「解説」セクションを参照してください。

このメソッドは、コンテンツをストリーミングし、Base64 コンテンツをデコードし、デコードされたバイナリ バイト (たとえば、インラインの Base64 エンコード GIF イメージ) をバッファーに返します。 このメソッドは、埋め込みテキストの大きなストリームを読み取るために連続して呼び出すことができます。 詳細については、RFC 1521「MIME (多目的インターネット メール拡張機能) パート 1: インターネット メッセージ本文の形式を指定および記述するためのメカニズム」を参照してください。 RFC は、 コメント要求 Web サイトから取得できます。

Note

メソッドが値 0 を返すまで、 ReadContentAsBase64 メソッドの呼び出しの間にリーダー プロパティにアクセスしないでください。

このメソッドの動作は次のとおりです。

  • ReadContentAsBase64 は、操作対象のバイト ストリームの末尾に達したときに値 0 を返します。 リーダーは、最初の非コンテンツ ノードに配置されます。

  • ストリームに残っているバイト数よりも少ないバイト数または正確な数を要求した場合、リーダーは現在の位置に残ります。

  • ReadContentAsBase64 は、要素、XmlDeclaration、None、Document、DocumentType、Notation、Entity、DocumentFragment の各 XML ノードタイプではサポートされていません。

適用対象

こちらもご覧ください