XmlReader.ReadContentAsBase64(Byte[], Int32, Int32) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
コンテンツを読み取り、Base64 でデコードされたバイナリ バイトを返します。
public:
virtual int ReadContentAsBase64(cli::array <System::Byte> ^ buffer, int index, int count);public virtual int ReadContentAsBase64 (byte[] buffer, int index, int count);abstract member ReadContentAsBase64 : byte[] * int * int -> int
override this.ReadContentAsBase64 : byte[] * int * int -> intPublic Overridable Function ReadContentAsBase64 (buffer As Byte(), index As Integer, count As Integer) As Integerパラメーター
- buffer
- Byte[]
結果として得られるテキストのコピー先のバッファー。 この値を null にすることはできません。
- index
- Int32
バッファー内の結果のコピー開始位置を示すオフセット。
- count
- Int32
バッファーにコピーする最大バイト数。 コピーされた実際のバイト数は、このメソッドから返されます。
戻り値
バッファーに書き込まれたバイト数。
例外
buffer 値は null です。
ReadContentAsBase64(Byte[], Int32, Int32) は、現在のノードではサポートされていません。
- または -
先行の非同期操作が完了する前に、XmlReader メソッドが呼び出されました。 この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。
バッファー内のインデックス、またはインデックスとカウントの合計値が、割り当てられているバッファー サイズを超えています。
XmlReader 実装が、このメソッドをサポートしていません。
注釈
このメソッドは、コンテンツをストリーミングし、コンテンツを Base64 デコードし、デコードされたバイナリ バイト (インライン Base64 でエンコードされた GIF イメージなど) をバッファーに返します。 このメソッドは、埋め込みテキストの大きなストリームを読み取るために連続して呼び出すことができます。 詳細については、RFC 1521「MIME (多目的インターネット メール拡張機能) パート 1: インターネット メッセージ本文の形式を指定および記述するためのメカニズム」を参照してください。 RFC は 、[コメントの要求] Web サイトから取得できます。
注意
メソッドが値0を返すまで、メソッドのReadContentAsBase64呼び出しの間にリーダー プロパティにアクセスしないでください。
このメソッドの動作は次のとおりです。
ReadContentAsBase64 は、動作していたバイト ストリームの末尾に達したときに値
0を返します。 リーダーは、最初の非コンテンツ ノードに配置されます。ストリームに残っているバイト数よりも少ないバイト数または正確なバイト数を要求した場合、リーダーは現在の位置に残ります。
ReadContentAsBase64は、次の XML ノードタイプではサポートされていません:
Element, ,XmlDeclaration,None,Document, ,DocumentType``Notation, ,Entity``DocumentFragment.
このメソッドの非同期バージョンについては、次を参照してください ReadContentAsBase64Async。