readtext-method-ado.md

title	TOCTitle	ms:assetid	ms:mtpsurl	ms:contentKeyID	ms.date	mtps_version	ms.localizationpriority
ReadText method (ADO)	ReadText method (ADO)	08f5bac4-dccd-696c-09a7-e1ba0cb38d79	https://msdn.microsoft.com/library/JJ248826(v=office.15)	48543108	09/18/2015	v=office.15	medium

ReadText method (ADO)

Applies to: Access 2013, Office 2013

Reads specified number of characters from a text Stream object.

Syntax

String = Stream.ReadText (NumChars)

Parameters

Parameter	Description
NumChars	Optional. A Long value that specifies the number of characters to read from the file, or a StreamReadEnum value. The default value is adReadAll.

Return value

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

If NumChar is more than the number of characters left in the stream, only the characters remaining are returned. The string read is not padded to match the length specified by NumChar. If there are no characters left to read, a variant whose value is null is returned. ReadText cannot be used to read backwards.

Note

The ReadText method is used with text streams (Type is adTypeText). For binary streams (Type is adTypeBinary), use Read.