XmlTextReader.ReadContentAsBase64 メソッドとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

XmlTextReader.ReadContentAsBase64 メソッド

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

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

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

Visual Basic (宣言)

Public Overrides Function
 ReadContentAsBase64 ( _
    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.ReadContentAsBase64(buffer, index, count)

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

C++

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

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

JScript

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

パラメータ

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

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

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

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

例外

例外の種類	条件
ArgumentNullException	buffer 値が null 参照 (Visual Basic では Nothing) です。
InvalidOperationException	ReadContentAsBase64 は、現在のノードではサポートされていません。
ArgumentOutOfRangeException	バッファ内のインデックス、またはインデックスとカウントの合計値が、割り当てられているバッファサイズを超えています。

解説

メモ
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 サイトから取得できます。

メモ
ReadContentAsBase64 メソッドを繰り返し呼び出している間は、メソッドから値 0 が返されるまで、リーダーのどのプロパティにもアクセスしないでください。