次の方法で共有


XmlTextReader.ReadElementContentAsBase64(Byte[], Int32, Int32) メソッド

定義

要素を読み取り、Base64 のコンテンツをデコードします。

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

パラメーター

buffer
Byte[]

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

index
Int32

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

count
Int32

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

戻り値

Int32

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

例外

buffer 値は null です。

現在のノードは要素ノードではありません。

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

XmlTextReader 実装が、このメソッドをサポートしていません。

要素には混合コンテンツが含まれます。

コンテンツを要求された型に変換できません。

このメソッドを使用する例を参照してください XmlReader.ReadElementContentAsBase64

注釈

注意

.NET Framework 2.0 以降では、このメソッドを使用してXmlReader.Create新しい機能を利用してインスタンスを作成XmlReaderすることをお勧めします。

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

このメソッドは、単純なコンテンツ要素のみを読み取ることができます。 要素には、テキスト、空白、重要な空白、CDATA セクション、コメント、および処理命令を含めることができます。 また、自動的に展開されるエンティティ参照を含めることもできます。 要素に子要素を含めることはできません。

このメソッドは、要素ノード型 ReadContentAsBase64 でのみ呼び出すことができる点を除いて、メソッドと非常によく似ています。

値が count ドキュメント内のバイト数より大きい場合、またはドキュメント内のバイト数と等しい場合は、ドキュメント内の残りのバイトをすべて読み取り、 XmlTextReader 読み取られたバイト数を返します。 次 XmlTextReader のメソッド呼び出しは 0 を返し、リーダーを次のノードに EndElement移動します。

すべての要素コンテンツを使用する前に呼び出 Read すと、リーダーは最初のコンテンツが使用されたかのように動作し、その後メソッドが Read 呼び出されたかのように動作する可能性があります。 つまり、リーダーは end 要素が検出されるまで、すべてのテキストを読み取ります。 次に、終了タグ ノードを読み取り、次のノードを読み取り、次のノードに配置します。

適用対象

こちらもご覧ください