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 を参照してください。
注釈
Note
新しい機能を利用するには、XmlReader クラスと XmlReaderSettings メソッドを使用してCreate インスタンスを作成することをお勧めします。 詳細については、「 XmlReader リファレンス」ページの「解説」セクションを参照してください。
このメソッドは、要素の内容を読み取り、BinHex エンコードを使用してデコードし、デコードされたバイナリ バイト (インライン BinHex エンコード GIF イメージなど) をバッファーに返します。
このメソッドは、単純なコンテンツ要素のみを読み取ることができます。 要素には、テキスト、空白、重要な空白、CDATA セクション、コメント、および処理命令を含めることができます。 また、自動的に展開されるエンティティ参照を含めることもできます。 要素に子要素を含めることはできません。
このメソッドは、要素ノード型でのみ呼び出すことができる点を除いて、 ReadContentAsBinHex メソッドとよく似ています。
カウント値がドキュメント内のバイト数より大きい場合、またはドキュメント内のバイト数と等しい場合、 XmlNodeReader はドキュメント内の残りのすべてのバイトを読み取り、読み取ったバイト数を返します。 次の XmlNodeReader メソッド呼び出しでは、0 が返され、リーダーが EndElement ノードの後のノードに移動します。
すべての要素コンテンツが使用される前に Read を呼び出すと、リーダーは最初のコンテンツが使用されたかのように動作し、次に Read メソッドが呼び出された可能性があります。 つまり、リーダーは、終了要素が検出されるまですべてのテキストを読み取ります。 次に、終了タグ ノードを読み取り、次のノードを読み取り、それ自体を次の後続のノードに配置します。
