XmlNodeReader.ReadElementContentAsBinHex(Byte[], Int32, Int32) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
要素を読み取り、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 -> intPublic Overrides Function ReadElementContentAsBinHex (buffer As Byte(), index As Integer, count As Integer) As Integerパラメーター
- buffer
- Byte[]
結果として得られるテキストのコピー先のバッファー。 この値を null にすることはできません。
- index
- Int32
バッファー内の結果のコピー開始位置を示すオフセット。
- count
- Int32
バッファーにコピーする最大バイト数。 コピーされた実際のバイト数は、このメソッドから返されます。
戻り値
バッファーに書き込まれたバイト数。
例外
buffer 値は null です。
現在のノードは要素ノードではありません。
バッファー内のインデックス、またはインデックスとカウントの合計値が、割り当てられているバッファー サイズを超えています。
要素には混合コンテンツが含まれます。
コンテンツを要求された型に変換できません。
例
このメソッドを使用した例を参照してください XmlReader.ReadElementContentAsBinHex 。
注釈
注意
.NET Framework 2.0 では、クラスとCreateメソッドを使用してインスタンスをXmlReaderSettings作成XmlReaderすることをお勧めします。 これにより、.NET Frameworkで導入されたすべての新機能を最大限に活用できます。 詳細については、リファレンス ページの「解説」セクションを XmlReader 参照してください。
このメソッドは、要素のコンテンツを読み取り、BinHex エンコードを使用してデコードし、デコードされたバイナリ バイト (インライン BinHex エンコード GIF イメージなど) をバッファーに返します。
このメソッドは、単純なコンテンツ要素のみを読み取ることができます。 要素には、テキスト、空白、重要な空白、CDATA セクション、コメント、および処理命令を含めることができます。 また、自動的に展開されるエンティティ参照を含めることもできます。 要素に子要素を含めることはできません。
このメソッドは、要素ノード型でのみ呼び出すことができる点を除いて、メソッドとよく似ています ReadContentAsBinHex 。
カウント値がドキュメント内のバイト数より大きい場合、またはドキュメント内のバイト数と等しい場合は、ドキュメント内の残りのすべてのバイトを読み取り、 XmlNodeReader 読み取られたバイト数を返します。 次 XmlNodeReader のメソッド呼び出しは 0 を返し、リーダーをノードの次のノードに EndElement 移動します。
すべての要素コンテンツが消費される前に呼び出 Read すと、リーダーは最初のコンテンツが消費され、メソッド Read が呼び出されたかのように動作する可能性があります。 つまり、リーダーは、end 要素が検出されるまで、すべてのテキストを読み取ります。 次に、終了タグ ノードを読み取り、次のノードを読み取り、それ自体を次の後続のノードに配置します。