英語で読む

次の方法で共有

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

  • リファレンス

定義

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

コンテンツを読み取り、Base64 でデコードされたバイナリ バイトを返します。

C# 
public virtual int ReadContentAsBase64 (byte[] buffer, int index, int count);

パラメーター

buffer
Byte[]

結果として得られるテキストのコピー先のバッファー。 この値を null にすることはできません。

index
Int32

バッファー内の結果のコピー開始位置を示すオフセット。

count
Int32

バッファーにコピーする最大バイト数。 コピーされた実際のバイト数は、このメソッドから返されます。

戻り値

Int32

バッファーに書き込まれたバイト数。

例外

ArgumentNullException

buffer 値は null です。

InvalidOperationException

ReadContentAsBase64(Byte[], Int32, Int32) は、現在のノードではサポートされていません。

  • または -

先行の非同期操作が完了する前に、XmlReader メソッドが呼び出されました。 この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。

ArgumentOutOfRangeException

バッファー内のインデックス、またはインデックスとカウントの合計値が、割り当てられているバッファー サイズを超えています。

NotSupportedException

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。

適用対象

製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

こちらもご覧ください