ReadText メソッドReadText Method

指定されたテキストの文字数を読み取りますStreamオブジェクト。Reads specified number of characters from a text Stream object.

構文Syntax

  
String = Stream.ReadText ( NumChars)  

パラメーターParameters

NumCharsNumChars
任意。Optional. A長いファイルから読み取る文字の数を指定する値またはStreamReadEnum値。A Long value that specifies the number of characters to read from the file, or a StreamReadEnum value. 既定値はadReadAllします。The default value is adReadAll.

戻り値Return Value

ReadTextメソッドは、指定された数の文字、行全体、または全体のストリームからを読み取り、 Streamオブジェクトし、結果の文字列を返します。The ReadText method reads a specified number of characters, an entire line, or the entire stream from a Stream object and returns the resulting string.

コメントRemarks

場合NumCharがストリームの左の文字数よりも多い、残りの文字のみが返されます。If NumChar is more than the number of characters left in the stream, only the characters remaining are returned. 指定された長さと一致する文字列の読み取りが行われていないNumCharします。The string read is not padded to match the length specified by NumChar. 読み取り対象文字がない場合は、バリアントの値は null が返されます。If there are no characters left to read, a variant whose value is null is returned. ReadText旧バージョンと読み取りに使用することはできません。ReadText cannot be used to read backwards.

注意

ReadTextメソッドは、テキスト ストリームの使用 (adTypeText)。The ReadText method is used with text streams (Type is adTypeText). バイナリ ストリームの (adTypeBinary) を使用して、読み取りします。For binary streams (Type is adTypeBinary), use Read.

クエリから返される XML データの量が大きくなる、 ReadText ActiveX データ オブジェクト (ADO) Stream オブジェクトのメソッドは、これを行う COM + コンポーネントから呼び出された場合; を実行する時間を大幅にかかる場合があります、ASP ページで、ユーザーのセッション タイムアウトになる可能性があります。ADO から utf-8 エンコードが Unicode; に Stream オブジェクト データを変換します一度に大量のデータの変換に関連するメモリが頻繁に再割り当てが非常に時間がかかります。Queries that result in a large amount of XML data being returned through the ReadText method of the ActiveX Data Object (ADO) Stream object may take a great deal of time to execute; if this is done in a COM+ component that is invoked from an ASP page, the user's session may time out. ADO converts Stream object data from UTF-8 encoding to Unicode; the frequent memory reallocation involved in conversion of such a large quantity of data at once is quite time-consuming. を解決することを繰り返し呼び出す、 ReadText ADO のメソッド、オブジェクトのコマンドし、より小さい文字数を指定します。To resolve, make repeated calls to the ReadText method of the ADO command object, and specify a smaller number of characters. 128 K (131,072) と等価の値が最適な表示がテストされます。Tests have shown that a value equivalent to 128K (131,072) is optimal. この値が減少すると、応答時間が減少します。Response time decreases as this value is decreased. 詳細については、サポート技術情報記事 280067 を参照してください。"[prb]。ADO のストリーム オブジェクトの ReadText メソッドを使用して SQL Server 2000 から非常に大きな XML ドキュメントを取得する場合があります"、Microsoft サポート技術情報で https://support.microsoft.com します。For more information, see Knowledge Base article 280067, "PRB: Retrieving very large XML Documents from SQL Server 2000 by using ReadText method of ADO stream object may be slow", in the Microsoft Knowledge Base at https://support.microsoft.com.

適用対象Applies To

Stream オブジェクト (ADO)Stream Object (ADO)

関連項目See Also

Read メソッドRead Method