StringReader.ReadLine Méthode

Définition

Espace de noms:

System.IO

Assembly:

System.Runtime.dll

Source:

StringReader.cs

Lit une ligne de caractères à partir de la chaîne en cours et retourne les données sous forme de chaîne.

public:
 override System::String ^ ReadLine();

public override string? ReadLine ();

override this.ReadLine : unit -> string

Public Overrides Function ReadLine () As String

Retours

String

Ligne suivante dans la chaîne actuelle ou null si la fin de la chaîne est atteinte.

Exceptions

ObjectDisposedException

Le lecteur actuel est fermé.

OutOfMemoryException

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

Exemples

Cet exemple de code fait partie d’un exemple plus grand fourni pour la StringReader classe .

// From textReaderText, create a continuous paragraph 
// with two spaces between each sentence.
   String^ aLine;
String^ aParagraph;
StringReader^ strReader = gcnew StringReader( textReaderText );
while ( true )
{
   aLine = strReader->ReadLine();
   if ( aLine != nullptr )
   {
      aParagraph = String::Concat( aParagraph, aLine,  " " );
   }
   else
   {
      aParagraph = String::Concat( aParagraph,  "\n" );
      break;
   }
}

Console::WriteLine(  "Modified text:\n\n{0}", aParagraph );

// From textReaderText, create a continuous paragraph
// with two spaces between each sentence.
string aLine, aParagraph = null;
StringReader strReader = new StringReader(textReaderText);
while(true)
{
    aLine = strReader.ReadLine();
    if(aLine != null)
    {
        aParagraph = aParagraph + aLine + " ";
    }
    else
    {
        aParagraph = aParagraph + "\n";
        break;
    }
}
Console.WriteLine("Modified text:\n\n{0}", aParagraph);

' From textReaderText, create a continuous paragraph 
' with two spaces between each sentence.
Dim aLine, aParagraph As String
Dim strReader As New StringReader(textReaderText)
While True
    aLine = strReader.ReadLine()
    If aLine Is Nothing Then
        aParagraph = aParagraph & vbCrLf
        Exit While
    Else
        aParagraph = aParagraph & aLine & " "
    End If
End While
Console.WriteLine("Modified text:" & vbCrLf & vbCrLf & _ 
    aParagraph)

Remarques

Cette méthode remplace la TextReader.ReadLine méthode .

Une ligne est définie comme une séquence de caractères suivie d’un flux de ligne (« \n »), d’un retour chariot (« \r »), d’un retour chariot immédiatement suivi d’un flux de ligne (« \r\n ») ou du marqueur de fin de flux. La chaîne retournée ne contient pas le retour chariot de fin ou le flux de ligne. La valeur retournée est null si le marqueur de fin de flux a été atteint. Autrement dit, s’il n’y a rien entre la dernière ligne lue et le marqueur de fin de flux, la méthode retourne null.

Si la méthode actuelle lève un OutOfMemoryException, la position du lecteur dans la chaîne sous-jacente est avancée par le nombre de caractères que la méthode a pu lire, mais les caractères déjà lus dans la mémoire tampon interne ReadLine sont ignorés. Étant donné que la position du lecteur dans la chaîne ne peut pas être modifiée, les caractères déjà lus sont irrécupérables et sont accessibles uniquement en réinitialisant le StringReader. Pour éviter une telle situation, utilisez la Read méthode et stockez les caractères de lecture dans une mémoire tampon préallouée.

Le tableau suivant répertorie des exemples d’autres tâches d’E/S classiques ou connexes.

Action à réaliser...	Consultez l'exemple décrit dans cette rubrique...
Créer un fichier texte.	Procédure : écrire du texte dans un fichier
Écrire dans un fichier texte.	Procédure : écrire du texte dans un fichier
Lire à partir d’un fichier texte.	Procédure : lire le texte d’un fichier
Ajoutez du texte à un fichier.	Procédure : ouvrir un fichier journal et y ajouter des éléments File.AppendText FileInfo.AppendText
Obtenir la taille d’un fichier.	FileInfo.Length
Obtenir les attributs d’un fichier.	File.GetAttributes
Définissez les attributs d’un fichier.	File.SetAttributes
Déterminez si un fichier existe.	File.Exists
Lire à partir d’un fichier binaire.	Procédure : lire et écrire dans un fichier de données créé récemment
Écrire dans un fichier binaire.	Procédure : lire et écrire dans un fichier de données créé récemment

Voir aussi

• E/S de fichier et de flux
• Procédure : lire le texte d’un fichier
• Procédure : écrire du texte dans un fichier