次の方法で共有


XmlTextReader.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 です。

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

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

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

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

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

このメソッドを使用した例を参照してください XmlReader.ReadElementContentAsBinHex

注釈

注意

.NET Framework 2.0 以降では、このメソッドを使用してXmlReader.Create新しい機能を利用してインスタンスを作成XmlReaderすることをお勧めします。

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

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

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

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

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

適用対象

こちらもご覧ください