ReadText メソッド

  • [アーティクル]

指定された文字数をテキスト Stream オブジェクトから読み取ります。

構文

  
String = Stream.ReadText ( NumChars)

パラメーター

NumChars
省略可能。 ファイルから読み取る文字数を指定する Long 値、または StreamReadEnum 値。 既定値は adReadAll です。

戻り値

ReadText メソッドは、指定した文字数、行全体、またはストリーム全体を Stream オブジェクトから読み取り、結果の文字列を返します。

注釈

NumChar がストリームに残っている文字数を超える場合は、残っている文字だけが返されます。 読み取られた文字列は、NumChar で指定された長さに合わせて埋め込まれません。 読み取る文字が残っていない場合は、値が null のバリアントが返されます。 ReadText を使用して逆方向に読み取ることはできません。

注意

ReadText メソッドは、テキスト ストリーム (Typeは adTypeText) で使用されます。 バイナリ ストリーム (Typeは adTypeBinary) では、Read を使用します。

ActiveX Data Object (ADO) Stream オブジェクトの ReadText メソッドを介して大量の XML データが返されるクエリでは、実行に時間がかかる場合があります。ASP ページから呼び出される COM+ コンポーネントでこれを行うと、ユーザーのセッションがタイムアウトになる可能性があります。ADO は Stream オブジェクト データを UTF-8 エンコードから Unicode に変換します。このような大量のデータを一度に変換する際に頻繁に発生するメモリ再割り当てには、非常に時間がかかります。 解決するには、ADO コマンド オブジェクトの ReadText メソッドを繰り返し呼び出し、より少ない文字数を指定します。 テストでは、128K (131,072) に相当する値が最適であることが示されています。 応答時間は、この値が減少すると減少します。 詳細については、Microsoft サポート技術情報 (https://support.microsoft.com) にあるナレッジ ベース記事 280067 の "PRB: Retrieving very large XML Documents from SQL Server 2000 by using ReadText method of ADO stream object may be slow (PRB: ADO Stream オブジェクトの ReadText メソッドを使用して SQL Server 2000 から非常に大きな XML ドキュメントを取得すると時間がかかる可能性がある)"を参照してください。

適用対象

Stream オブジェクト (ADO)

参照

Read メソッド