XmlNodeReader.ReadContentAsBinHex(Byte[], Int32, Int32) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
コンテンツを読み取り、BinHex でデコードされたバイナリ バイトを返します。
public:
override int ReadContentAsBinHex(cli::array <System::Byte> ^ buffer, int index, int count);public override int ReadContentAsBinHex (byte[] buffer, int index, int count);override this.ReadContentAsBinHex : byte[] * int * int -> intPublic Overrides Function ReadContentAsBinHex (buffer As Byte(), index As Integer, count As Integer) As Integerパラメーター
- buffer
- Byte[]
結果として得られるテキストのコピー先のバッファー。 この値を null にすることはできません。
- index
- Int32
バッファー内の結果のコピー開始位置を示すオフセット。
- count
- Int32
バッファーにコピーする最大バイト数。 コピーされた実際のバイト数は、このメソッドから返されます。
戻り値
バッファーに書き込まれたバイト数。
例外
buffer 値は null です。
ReadContentAsBinHex(Byte[], Int32, Int32) は、現在のノードではサポートされていません。
バッファー内のインデックス、またはインデックスとカウントの合計値が、割り当てられているバッファー サイズを超えています。
注釈
Note
.NET Framework 2.0 では、 クラスと Create メソッドを使用してXmlReaderSettingsインスタンスを作成XmlReaderすることをお勧めします。 これにより、.NET Frameworkで導入されたすべての新機能を最大限に活用できます。 詳細については、リファレンス ページの「解説」セクションを XmlReader 参照してください。
このメソッドは、コンテンツをストリーミングし、BinHex コンテンツをデコードし、デコードされたバイナリ バイト (インラインの BinHex エンコード GIF イメージなど) をバッファーに返します。 このメソッドは、埋め込みテキストの大きなストリームを読み取るために連続して呼び出すことができます。
Note
メソッドが値 0 を返すまで、メソッドの ReadContentAsBinHex 呼び出しの間にリーダー プロパティにアクセスしないでください。
このメソッドの動作は次のとおりです。
ReadContentAsBinHex は、操作対象のバイト ストリームの末尾に達したときに値 0 を返します。 リーダーは、コンテンツ以外の最初のノードに配置されます。
ストリームに残っているバイト数よりも少ないバイト数または正確な数を求める場合、リーダーは現在の位置に残ります。
ReadContentAsBinHex は、次の XML ノードの種類ではサポートされていません: Element、XmlDeclaration、None、Document、DocumentType、Notation、Entity、DocumentFragment。
適用対象
こちらもご覧ください
.NET