ReadText, méthode
Lit le nombre spécifié de caractères à partir d’un texte Objet Stream.
Syntaxe
String = Stream.ReadText ( NumChars)
Paramètres
numChars
Optionnel. Valeur long qui spécifie le nombre de caractères à lire à partir du fichier, ou une valeur StreamReadEnum. La valeur par défaut est adReadAll.
Valeur de retour
La méthode ReadText lit un nombre spécifié de caractères, une ligne entière ou l’ensemble du flux à partir d’un objet Stream et retourne la chaîne résultante.
Remarques
Si NumChar est supérieur au nombre de caractères laissés dans le flux, seuls les caractères restants sont retournés. La lecture de chaîne n’est pas rembourrée pour correspondre à la longueur spécifiée par NumChar. S’il n’y a pas de caractères à lire, une variante dont la valeur est Null est retournée. ReadText ne peut pas être utilisé pour lire vers l’arrière.
Note
La méthode ReadText est utilisée avec des flux de texte (Type est adTypeText). Pour les flux binaires (Type est adTypeBinary), utilisez Lecture.
Les requêtes qui entraînent un grand nombre de données XML retournées par le biais de la méthode ReadText de l’objet Objet de données ActiveX (ADO) peuvent prendre beaucoup de temps pour s’exécuter ; si cette opération est effectuée dans un composant COM+ appelé à partir d’une page ASP, la session de l’utilisateur peut expirer. ADO convertit les données d’objet Stream de l’encodage UTF-8 en Unicode ; la réaffectation fréquente de la mémoire impliquée dans la conversion d’une telle grande quantité de données à la fois est assez longue. Pour résoudre ce problème, effectuez des appels répétés à l'méthode ReadText de l’objet de commande ADO et spécifiez un plus petit nombre de caractères. Les tests ont montré qu’une valeur équivalente à 128K (131 072) est optimale. Le temps de réponse diminue à mesure que cette valeur est réduite. Pour plus d’informations, consultez l’article de la Base de connaissances 280067« PRB : Récupération de documents XML très volumineux à partir de SQL Server 2000 à l’aide de la méthode ReadText de l’objet de flux ADO peut être lent », dans la Base de connaissances Microsoft à https://support.microsoft.com.