XmlNodeReader.ReadElementContentAsBinHex メソッド

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

XmlNodeReader.ReadElementContentAsBinHex メソッド

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

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

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

Visual Basic (宣言)

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

Visual Basic (使用法)

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

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

C#

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

C++

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

J#

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

JScript

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

パラメータ

buffer

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

index

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

count

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

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

例外

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

解説

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

このメソッドは、コンテンツを読み取り、BinHex エンコーディングを使用してコンテンツをデコードしてから、デコードされたバイナリ バイト (BinHex でエンコードされたインライン GIF イメージなど) をバッファに返します。

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

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

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

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

使用例

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

プラットフォーム

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

参照

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