次の方法で共有


XmlReader.ReadContentAsBinHex(Byte[], Int32, Int32) メソッド

定義

コンテンツを読み取り、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 -> int
Public Overridable Function ReadContentAsBinHex (buffer As Byte(), index As Integer, count As Integer) As Integer

パラメーター

buffer
Byte[]

結果として得られるテキストのコピー先のバッファー。 この値を null にすることはできません。

index
Int32

バッファー内の結果のコピー開始位置を示すオフセット。

count
Int32

バッファーにコピーする最大バイト数。 コピーされた実際のバイト数は、このメソッドから返されます。

戻り値

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

適用対象

こちらもご覧ください