StreamReader.ReadToEnd Méthode

  • Référence

Définition

Espace de noms:
System.IO
Assembly:
System.IO.dll
Assembly:
System.Runtime.dll
Assembly:
netstandard.dll
Assembly:
System.Runtime.Extensions.dll
Assembly:
mscorlib.dll

Lit tous les caractères entre la position actuelle et la fin du flux.

public:
 override System::String ^ ReadToEnd();
public override string ReadToEnd ();
override this.ReadToEnd : unit -> string
Public Overrides Function ReadToEnd () As String

Retours

String

Le reste du flux sous forme de chaîne, de la position actuelle jusqu'à la fin. Si la position actuelle est à la fin du flux, retourne une chaîne vide ("").

Exceptions

OutOfMemoryException

La mémoire est insuffisante pour allouer une mémoire tampon à la chaîne retournée.

IOException

Une erreur d’E/S se produit.

Exemples

L’exemple de code suivant lit tout jusqu’à la fin d’un fichier en une seule opération.

using namespace System;
using namespace System::IO;
int main()
{
   String^ path = "c:\\temp\\MyTest.txt";
   try
   {
      if ( File::Exists( path ) )
      {
         File::Delete( path );
      }
      StreamWriter^ sw = gcnew StreamWriter( path );
      try
      {
         sw->WriteLine( "This" );
         sw->WriteLine( "is some text" );
         sw->WriteLine( "to test" );
         sw->WriteLine( "Reading" );
      }
      finally
      {
         delete sw;
      }

      StreamReader^ sr = gcnew StreamReader( path );
      try
      {
         //This allows you to do one Read operation.
         Console::WriteLine( sr->ReadToEnd() );
      }
      finally
      {
         delete sr;
      }
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "The process failed: {0}", e );
   }
}

using System;
using System.IO;

class Test
{
    
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";

        try
        {
            if (File.Exists(path))
            {
                File.Delete(path);
            }

            using (StreamWriter sw = new StreamWriter(path))
            {
                sw.WriteLine("This");
                sw.WriteLine("is some text");
                sw.WriteLine("to test");
                sw.WriteLine("Reading");
            }

            using (StreamReader sr = new StreamReader(path))
            {
                //This allows you to do one Read operation.
                Console.WriteLine(sr.ReadToEnd());
            }
        }
        catch (Exception e)
        {
            Console.WriteLine("The process failed: {0}", e.ToString());
        }
    }
}

Imports System.IO
Imports System.Text

Public Class Test

    Public Shared Sub Main()
        Dim path As String = "c:\temp\MyTest.txt"

        Try
            If File.Exists(path) Then
                File.Delete(path)
            End If

            Dim sw As StreamWriter = New StreamWriter(path)
            sw.WriteLine("This")
            sw.WriteLine("is some text")
            sw.WriteLine("to test")
            sw.WriteLine("Reading")
            sw.Close()

            Dim sr As StreamReader = New StreamReader(path)

            'This allows you to do one Read operation.
            Console.WriteLine(sr.ReadToEnd())
            sr.Close()
        Catch e As Exception
            Console.WriteLine("The process failed: {0}", e.ToString())
        End Try
    End Sub
End Class

Remarques

Cette méthode se substitue à TextReader.ReadToEnd.

ReadToEnd fonctionne mieux lorsque vous devez lire toutes les entrées à partir de la position actuelle jusqu’à la fin du flux. Si vous avez besoin de davantage de contrôle sur le nombre de caractères lus à partir du flux, utilisez la Read(Char[], Int32, Int32) surcharge de méthode, qui produit généralement de meilleures performances.

ReadToEnd suppose que le flux sache quand il a atteint une fin. Pour les protocoles interactifs dans lesquels le serveur envoie des données uniquement lorsque vous le demandez et ne ferme pas la connexion, ReadToEnd peut se bloquer indéfiniment, car il n’atteint pas une fin et doit être évité.

Notez que lors de l’utilisation de la Read méthode, il est plus efficace d’utiliser une mémoire tampon de la même taille que la mémoire tampon interne du flux. Si la taille de la mémoire tampon n’a pas été spécifiée lors de la construction du flux, sa taille par défaut est de 4 kilo-octets (4096 octets).

Si la méthode actuelle lève une OutOfMemoryException , la position du lecteur dans l’objet sous-jacent Stream est avancée du nombre de caractères que la méthode a pu lire, mais les caractères déjà lus dans la ReadLine mémoire tampon interne sont ignorés. Si vous manipulez la position du flux sous-jacent après avoir lu les données dans la mémoire tampon, la position du flux sous-jacent peut ne pas correspondre à la position de la mémoire tampon interne. Pour réinitialiser la mémoire tampon interne, appelez la DiscardBufferedData méthode. Toutefois, cette méthode ralentit les performances et doit être appelée uniquement lorsque cela est absolument nécessaire.

Pour obtenir la liste des tâches d’e/s courantes, consultez tâches d’e/s courantes.

S’applique à

Voir aussi