File.ReadAllLines Méthode

Définition

Ouvre un fichier texte, lit toutes les lignes du fichier dans un tableau de chaînes, puis ferme le fichier.

Surcharges

Nom Description
ReadAllLines(String)

Ouvre un fichier texte, lit toutes les lignes du fichier, puis ferme le fichier.

ReadAllLines(String, Encoding)

Ouvre un fichier, lit toutes les lignes du fichier avec l’encodage spécifié, puis ferme le fichier.

ReadAllLines(String)

Source:
File.cs
Source:
File.cs
Source:
File.cs
Source:
File.cs
Source:
File.cs

Ouvre un fichier texte, lit toutes les lignes du fichier, puis ferme le fichier.

public:
 static cli::array <System::String ^> ^ ReadAllLines(System::String ^ path);
public static string[] ReadAllLines(string path);
static member ReadAllLines : string -> string[]
Public Shared Function ReadAllLines (path As String) As String()

Paramètres

path
String

Fichier à ouvrir pour la lecture.

Retours

String[]

Tableau de chaînes contenant toutes les lignes du fichier.

Exceptions

.NET Framework et les versions .NET Core antérieures à 2.1 : path est une chaîne de longueur nulle, contient uniquement un espace blanc ou contient un ou plusieurs caractères non valides. Vous pouvez rechercher des caractères non valides à l’aide de la méthode GetInvalidPathChars().

path a la valeur null.

Le chemin d’accès spécifié, le nom de fichier ou les deux dépassent la longueur maximale définie par le système.

Le chemin spécifié n’est pas valide (par exemple, il se trouve sur un lecteur non mappé).

Une erreur d’E/S s’est produite lors de l’ouverture du fichier.

Cette opération n’est pas prise en charge sur la plateforme actuelle.

- ou -

path spécifié un répertoire.

- ou -

L’appelant n’a pas l’autorisation requise.

Le fichier spécifié dans path n’a pas été trouvé.

path est dans un format non valide.

L’appelant n’a pas l’autorisation requise.

Exemples

L’exemple de code suivant illustre l’utilisation de la ReadAllLines méthode pour afficher le contenu d’un fichier. Dans cet exemple, un fichier est créé, s’il n’existe pas déjà, et le texte est ajouté à celui-ci.

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

        // This text is added only once to the file.
        if (!File.Exists(path))
        {
            // Create a file to write to.
            string[] createText = { "Hello", "And", "Welcome" };
            File.WriteAllLines(path, createText);
        }

        // This text is always added, making the file longer over time
        // if it is not deleted.
        string appendText = "This is extra text" + Environment.NewLine;
        File.AppendAllText(path, appendText);

        // Open the file to read from.
        string[] readText = File.ReadAllLines(path);
        foreach (string s in readText)
        {
            Console.WriteLine(s);
        }
    }
}
open System
open System.IO

let path = @"c:\temp\MyTest.txt"

// This text is added only once to the file.
if File.Exists path |> not then
    // Create a file to write to.
    let createText = [ "Hello"; "And"; "Welcome" ]
    File.WriteAllLines(path, createText)

// This text is always added, making the file longer over time
// if it is not deleted.
let appendText =
    "This is extra text" + Environment.NewLine

File.AppendAllText(path, appendText)

// Open the file to read from.
let readText = File.ReadAllLines path

for s in readText do
    printfn $"{s}"
Imports System.IO

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

        ' This text is added only once to the file.
        If File.Exists(path) = False Then

            ' Create a file to write to.
            Dim createText() As String = {"Hello", "And", "Welcome"}
            File.WriteAllLines(path, createText)
        End If

        ' This text is always added, making the file longer over time
        ' if it is not deleted.
        Dim appendText As String = "This is extra text" + Environment.NewLine
        File.AppendAllText(path, appendText)

        ' Open the file to read from.
        Dim readText() As String = File.ReadAllLines(path)
        Dim s As String
        For Each s In readText
            Console.WriteLine(s)
        Next
    End Sub
End Class

Remarques

Cette méthode ouvre un fichier, lit chaque ligne du fichier, puis ajoute chaque ligne en tant qu’élément d’un tableau de chaînes. Il ferme ensuite le fichier. Une ligne est définie comme une séquence de caractères suivie d’un retour chariot ('\r'), d’un saut de ligne ('\n') ou d’un retour chariot immédiatement suivi d’un flux de ligne. La chaîne résultante ne contient pas le retour chariot de fin et/ou le flux de ligne.

Si le fichier se termine par une séquence de sauts de ligne, aucune ligne vide supplémentaire n’est ajoutée au tableau. Par exemple, un fichier contenant "line1\nline2\n" produit le même tableau à deux éléments (["line1", "line2"]) qu’un fichier contenant "line1\nline2".

Cette méthode tente de détecter automatiquement l’encodage d’un fichier en fonction de la présence de marques d’ordre d’octet. Les formats d’encodage UTF-8 et UTF-32 (big-endian et little-endian) peuvent être détectés.

Voir aussi

S’applique à

ReadAllLines(String, Encoding)

Source:
File.cs
Source:
File.cs
Source:
File.cs
Source:
File.cs
Source:
File.cs

Ouvre un fichier, lit toutes les lignes du fichier avec l’encodage spécifié, puis ferme le fichier.

public:
 static cli::array <System::String ^> ^ ReadAllLines(System::String ^ path, System::Text::Encoding ^ encoding);
public static string[] ReadAllLines(string path, System.Text.Encoding encoding);
static member ReadAllLines : string * System.Text.Encoding -> string[]
Public Shared Function ReadAllLines (path As String, encoding As Encoding) As String()

Paramètres

path
String

Fichier à ouvrir pour la lecture.

encoding
Encoding

Encodage appliqué au contenu du fichier.

Retours

String[]

Tableau de chaînes contenant toutes les lignes du fichier.

Exceptions

.NET Framework et les versions .NET Core antérieures à 2.1 : path est une chaîne de longueur nulle, contient uniquement un espace blanc ou contient un ou plusieurs caractères non valides. Vous pouvez rechercher des caractères non valides à l’aide de la méthode GetInvalidPathChars().

path a la valeur null.

Le chemin d’accès spécifié, le nom de fichier ou les deux dépassent la longueur maximale définie par le système.

Le chemin spécifié n’est pas valide (par exemple, il se trouve sur un lecteur non mappé).

Une erreur d’E/S s’est produite lors de l’ouverture du fichier.

Cette opération n’est pas prise en charge sur la plateforme actuelle.

- ou -

path spécifié un répertoire.

- ou -

L’appelant n’a pas l’autorisation requise.

Le fichier spécifié dans path n’a pas été trouvé.

path est dans un format non valide.

L’appelant n’a pas l’autorisation requise.

Exemples

L’exemple de code suivant illustre l’utilisation de la ReadAllLines méthode pour afficher le contenu d’un fichier. Dans cet exemple, un fichier est créé, s’il n’existe pas déjà, et le texte est ajouté à celui-ci.

using System;
using System.IO;
using System.Text;

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

        // This text is added only once to the file.
        if (!File.Exists(path))
        {
            // Create a file to write to.
            string[] createText = { "Hello", "And", "Welcome" };
            File.WriteAllLines(path, createText, Encoding.UTF8);
        }

        // This text is always added, making the file longer over time
        // if it is not deleted.
        string appendText = "This is extra text" + Environment.NewLine;
        File.AppendAllText(path, appendText, Encoding.UTF8);

        // Open the file to read from.
        string[] readText = File.ReadAllLines(path, Encoding.UTF8);
        foreach (string s in readText)
        {
            Console.WriteLine(s);
        }
    }
}
open System
open System.IO
open System.Text

let path = @"c:\temp\MyTest.txt"

// This text is added only once to the file.
if File.Exists path |> not then
    // Create a file to write to.
    let createText = [ "Hello"; "And"; "Welcome" ]
    File.WriteAllLines(path, createText, Encoding.UTF8)

// This text is always added, making the file longer over time
// if it is not deleted.
let appendText =
    "This is extra text" + Environment.NewLine

File.AppendAllText(path, appendText, Encoding.UTF8)

// Open the file to read from.
let readText = File.ReadAllLines(path, Encoding.UTF8)

for s in readText do
    printfn $"{s}"
Imports System.IO
Imports System.Text

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

        ' This text is added only once to the file.
        If File.Exists(path) = False Then

            ' Create a file to write to.
            Dim createText() As String = {"Hello", "And", "Welcome"}
            File.WriteAllLines(path, createText, Encoding.UTF8)
        End If

        ' This text is always added, making the file longer over time
        ' if it is not deleted.
        Dim appendText As String = "This is extra text" + Environment.NewLine
        File.AppendAllText(path, appendText, Encoding.UTF8)

        ' Open the file to read from.
        Dim readText() As String = File.ReadAllLines(path, Encoding.UTF8)
        Dim s As String
        For Each s In readText
            Console.WriteLine(s)
        Next
    End Sub
End Class

Remarques

Cette méthode ouvre un fichier, lit chaque ligne du fichier, puis ajoute chaque ligne en tant qu’élément d’un tableau de chaînes. Il ferme ensuite le fichier. Une ligne est définie comme une séquence de caractères suivie d’un retour chariot ('\r'), d’un saut de ligne ('\n') ou d’un retour chariot immédiatement suivi d’un flux de ligne. La chaîne résultante ne contient pas le retour chariot de fin et/ou le flux de ligne.

Si le fichier se termine par une séquence de sauts de ligne, aucune ligne vide supplémentaire n’est ajoutée au tableau. Par exemple, un fichier contenant "line1\nline2\n" produit le même tableau à deux éléments (["line1", "line2"]) qu’un fichier contenant "line1\nline2".

Cette méthode tente de détecter automatiquement l’encodage d’un fichier en fonction de la présence de marques d’ordre d’octet. Les formats d’encodage UTF-8 et UTF-32 (big-endian et little-endian) peuvent être détectés.

Voir aussi

S’applique à