XmlValidatingReader.ReadElementContentAsBinHex(Byte[], Int32, Int32) メソッド

定義

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

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

パラメーター

buffer
Byte[]

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

index
Int32

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

count
Int32

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

戻り値

Int32

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

例外

buffer 値は null です。

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

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

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

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

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

注釈

注意

このクラスはXmlValidatingReader、.NET Framework 2.0 では廃止されています。 クラスとメソッドを使用してXmlReaderSettings、検証XmlReaderインスタンスをCreate作成できます。 詳細については、XmlReader のリファレンス ページの「解説」を参照してください。

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

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

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

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

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

適用対象

こちらもご覧ください