XmlReader.ReadContentAsBinHex(Byte[], Int32, Int32) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
コンテンツを読み取り、BinHex でデコードされたバイナリ バイトを返します。
public:
virtual int ReadContentAsBinHex(cli::array <System::Byte> ^ buffer, int index, int count);public virtual int ReadContentAsBinHex (byte[] buffer, int index, int count);abstract member ReadContentAsBinHex : byte[] * int * int -> int
override this.ReadContentAsBinHex : byte[] * int * int -> intPublic Overridable 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) は、現在のノードではサポートされていません。
- または -
先行の非同期操作が完了する前に、XmlReader メソッドが呼び出されました。 この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。
バッファー内のインデックス、またはインデックスとカウントの合計値が、割り当てられているバッファー サイズを超えています。
XmlReader 実装が、このメソッドをサポートしていません。
注釈
このメソッドは、コンテンツをストリーミングし、コンテンツを BinHex デコードし、デコードされたバイナリ バイト (インライン BinHex でエンコードされた GIF イメージなど) をバッファーに返します。 このメソッドは、埋め込みテキストの大きなストリームを読み取るために連続して呼び出すことができます。
注意
メソッドが値0を返すまで、メソッドのReadContentAsBinHex呼び出しの間にリーダー プロパティにアクセスしないでください。
このメソッドの動作は次のとおりです。
ReadContentAsBinHex は、動作していたバイト ストリームの末尾に達したときに値
0を返します。 リーダーは、最初の非コンテンツ ノードに配置されます。ストリームに残っているバイト数よりも少ないバイト数または正確なバイト数を要求した場合、リーダーは現在の位置に残ります。
ReadContentAsBinHex は、次の XML ノードタイプではサポートされていません:
Element, ,XmlDeclaration,None,Document,DocumentType,Notation, Entity,DocumentFragment.
このメソッドの非同期バージョンについては、次を参照してください ReadContentAsBinHexAsync。