StringReader.ReadLine Méthode

Définition

Espace de noms:

System.IO

Assemblys:

netstandard.dll, System.Runtime.dll

Source:

StringReader.cs

Lit une ligne de caractères de la chaîne actuelle 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 de 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 pour 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, 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 saut de ligne («\n»), d’un retour chariot («\r»), d’un retour chariot immédiatement suivi d’un saut 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 chaîne se termine par une séquence de sauts de ligne, aucune ligne vide supplémentaire n’est retournée. Par exemple, la chaîne "line1\nline2\n" produit les mêmes deux lignes ("line1" et "line2") que la chaîne "line1\nline2".

Si la méthode actuelle lève une OutOfMemoryExceptionposition 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 ne sont pas ré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.

Pour ce faire...	Consultez l’exemple de cette rubrique...
Créez un fichier texte.	Guide pratique pour écrire du texte dans un fichier
Écrivez dans un fichier texte.	Guide pratique pour écrire du texte dans un fichier
Lire à partir d’un fichier texte.	Guide pratique pour lire du texte à partir d’un fichier
Ajoutez du texte à un fichier.	Guide pratique pour ouvrir et ajouter à un fichier journal File.AppendText FileInfo.AppendText
Obtenez 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.	Guide pratique pour lire et écrire dans un fichier de données nouvellement créé
Écrivez dans un fichier binaire.	Guide pratique pour lire et écrire dans un fichier de données nouvellement créé

Voir aussi

• E/S de fichier et de flux
• Guide pratique pour lire du texte à partir d’un fichier
• Guide pratique pour écrire du texte dans un fichier