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

定義

名前空間:

System.Xml

アセンブリ:

System.Xml.ReaderWriter.dll

ソース:

XmlTextReader.cs

コンテンツを読み取り、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 -> int

Public Overrides Function ReadContentAsBinHex (buffer As Byte(), index As Integer, count As Integer) As Integer

パラメーター

buffer

Byte[]

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

index

Int32

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

count

Int32

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

戻り値

Int32

バッファーに書き込まれたバイト数。

例外

ArgumentNullException

buffer 値は null です。

InvalidOperationException

ReadContentAsBinHex(Byte[], Int32, Int32) は、現在のノードではサポートされていません。

ArgumentOutOfRangeException

バッファー内のインデックス、またはインデックスとカウントの合計値が、割り当てられているバッファー サイズを超えています。

NotSupportedException

XmlTextReader 実装が、このメソッドをサポートしていません。

注釈

Note

.NET Framework 2.0 以降では、 メソッドを使用してXmlReader.Create新しい機能を利用してインスタンスを作成XmlReaderすることをお勧めします。

このメソッドは、コンテンツをストリーミングし、コンテンツを BinHex デコードし、デコードされたバイナリ バイト (インライン BinHex でエンコードされた GIF イメージなど) をバッファーに返します。 このメソッドを連続して呼び出して、埋め込みテキストの大きなストリームを読み取ることができます。

Note

メソッドが値 0 を返すまで、メソッドの ReadContentAsBinHex 呼び出しの間にリーダー プロパティにアクセスしないでください。

このメソッドの動作は次のとおりです。

• ReadContentAsBinHex は、操作対象のバイト ストリームの末尾に達したときに値 0 を返します。 リーダーは、最初の非コンテンツ ノードに配置されます。

• ストリームに残っているバイト数よりも少ないバイト数 (正確な数) を求める場合、リーダーは現在の位置に残ります。

• ReadContentAsBinHexは、、 の XML ノードの種類ではサポートされていません。 ElementXmlDeclarationNoneDocumentDocumentTypeNotationEntityDocumentFragment

こちらもご覧ください

• XmlReader
• ReadElementContentAsBinHex(Byte[], Int32, Int32)
• XmlNodeType