Partager via

ReadText, méthode

  • Article

Lit un nombre spécifié de caractères à partir d’un objet Stream de texte.

Syntaxe

  
String = Stream.ReadText ( NumChars)

Paramètres

NumChars
facultatif. Valeur Long spécifiant le nombre de caractères à lire à partir du fichier, ou une valeur de StreamReadEnum. La valeur par défaut est adReadAll.

Valeur renvoyée

La méthode ReadText lit un nombre spécifié de caractères, une ligne entière ou le flux entier d’un objet Stream, et retourne la chaîne obtenue.

Notes

Si la valeur NumChar est supérieure au nombre de caractères laissés dans le flux, seuls les caractères restants sont retournés. La chaîne lue n’est pas complétée pour correspondre à la longueur spécifiée par la valeur NumChar. S’il ne reste plus de caractères à lire, un variant de valeur null est retournée. La méthode ReadText ne peut pas être utilisée pour lire vers l’arrière.

Notes

La méthode ReadText est utilisée avec des flux de texte (TypeadTypeText). Pour des flux binaires (TypeadTypeBinary), utilisez Read.

L’exécution de requêtes qui entraînent le retour d’une grande quantité de données XML via la méthode ReadText de l’objet Stream ActiveX Data Object (ADO) peut prendre beaucoup de temps. Si elle 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, et la réaffectation fréquente de mémoire qu’implique la conversion d’un tel volume de données à la fois est extrêmement chronophage. Pour résoudre ce problème, effectuez des appels répétés à la méthode ReadText de l’objet commande ADO, et spécifiez un nombre de caractères inférieur. Les tests montrent qu’une valeur égale à 128K (131 072) est optimale. Le temps de réponse diminue lorsque cette valeur est réduite. Pour plus d’informations, consultez l’article 280067 de la Base de connaissances, « PRB: Retrieving very large XML Documents from SQL Server 2000 by using ReadText method of ADO stream object may be slow », à l’adresse https://support.microsoft.com.

S'applique à

Stream, objet (ADO)

Voir aussi

Read, méthode