XmlTextReader.ReadElementContentAsBase64 メソッド

.NET Framework クラス ライブラリ リファレンス

XmlTextReader.ReadElementContentAsBase64 メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.Xml
アセンブリ: System.Xml (system.xml.dll 内)
構文

Visual Basic (宣言)

Public Overrides Function
 ReadElementContentAsBase64 ( _
    buffer As Byte(), _
    index As Integer, _
    count As Integer _
) As Integer

Visual Basic (使用法)

Dim instance As XmlTextReader
Dim buffer As Byte()
Dim index As Integer
Dim count As Integer
Dim returnValue As Integer

returnValue = instance.ReadElementContentAsBase64(buffer, index, count)

C#

public override int ReadElementContentAsBase64
 (
    byte[] buffer,
    int index,
    int count
)

C++

public:
virtual int ReadElementContentAsBase64 (
    array<unsigned char>^ buffer, 
    int index, 
    int count
) override

J#

public int ReadElementContentAsBase64 (
    byte[] buffer, 
    int index, 
    int count
)

JScript

public override function ReadElementContentAsBase64
 (
    buffer : byte[], 
    index : int, 
    count : int
) : int

パラメータ

buffer

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

index

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

count

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

戻り値
バッファに書き込まれたバイト数。

例外

例外の種類	条件
ArgumentNullException	buffer 値が null 参照 (Visual Basic では Nothing) です。
InvalidOperationException	現在のノードは要素ノードではありません。
ArgumentOutOfRangeException	バッファ内のインデックス、またはインデックスとカウントの合計値が、割り当てられているバッファ サイズを超えています。
NotSupportedException	その XmlTextReader 実装が、このメソッドをサポートしていません。
XmlException	要素には混合コンテンツが含まれます。
FormatException	コンテンツを要求された型に変換できません。

解説

メモ
Microsoft .NET Framework version 2.0 リリースでは、System.Xml.XmlReader.Create メソッドを使用して XmlReader インスタンスを作成することをお勧めします。これにより、このリリースで導入された新機能を十分に活用できます。詳細については、「XML リーダーの作成」を参照してください。

このメソッドは、要素のコンテンツを読み取り、Base64 エンコーディングを使用してコンテンツをデコードしてから、デコードされたバイナリ バイト (Base64 でエンコードされたインライン GIF イメージなど) をバッファに返します。詳細については、RFC 1521『MIME (Multipurpose Internet Mail Exensions) Part One: Mechanisms for Specifying and Describing the Format of Internet Message Bodies』を参照してください。RFC は、http://www.rfc-editor.org にある Request for Comments の Web サイトから取得できます。

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

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

count 値がドキュメント内のバイト数よりも大きい、または同じである場合は、XmlTextReader はドキュメント内の残りのバイトをすべて読み取り、読み取ったバイト数を返します。次の XmlTextReader メソッド呼び出しはゼロを返して、EndElement の次のノードにリーダーを移動します。

要素のすべてのコンテンツが処理される前に Read を呼び出すと、リーダーは、最初のコンテンツが処理された後で Read メソッドが呼び出された場合のように動作することがあります。つまりリーダーは、末尾の要素に到達するまですべてのテキストを読み取ります。次に終了タグ ノードを読み取り、次のノードを読み取ってから、後続のノード上に自身を配置します。

使用例

このメソッドの使用例については、XmlReader.ReadElementContentAsBase64 のトピックを参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
XmlTextReader クラス
XmlTextReader メンバ
System.Xml 名前空間
ReadElementContentAsBase64
その他の技術情報
XmlReader による XML の読み取り