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

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

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

XmlTextReader.ReadContentAsBinHex メソッド

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

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

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

Visual Basic (宣言)

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

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

C++

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

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

JScript

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

パラメータ

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

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

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

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

例外

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

解説

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

このメソッドは、コンテンツをストリーム転送し、BinHex のコンテンツをデコードして、デコードされたバイナリバイト (BinHex でエンコードされたインライン GIF イメージなど) をバッファに返します。このメソッドを連続して呼び出すと、埋め込みテキストの大量のストリームを読み取ることができます。

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