File.ReadAllLines Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Ouvre un fichier texte, lit toutes les lignes du fichier dans un tableau de chaînes, puis ferme le fichier.
Surcharges
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
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 lecture.
Retours
Tableau de chaînes contenant toutes les lignes du fichier.
Exceptions
.NET Framework et .NET Core versions antérieures à 2.1 : path
est une chaîne de longueur nulle, contient uniquement des espaces blancs ou contient un ou plusieurs caractères non valides. Vous pouvez rechercher les caractères non valides à l’aide de la méthode GetInvalidPathChars().
path
a la valeur null
.
Le chemin et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système.
Le chemin spécifié n’est pas valide (par exemple, il est sur un lecteur non mappé).
Une erreur d’E/S s’est produite lors de l’ouverture du fichier.
path
a spécifié un fichier en lecture seule.
- ou -
Cette opération n'est pas prise en charge sur la plateforme actuelle.
- ou -
path
a spécifié un répertoire.
- ou -
L'appelant n'a pas l'autorisation requise.
Le fichier spécifié dans path
est introuvable.
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 du texte y est ajouté.
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 flux 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.
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
- Fichier et flux de données E/S
- Lecture de texte à partir d’un fichier
- Procédure : écrire du texte dans un fichier
- Procédure : lire et écrire dans un fichier de données créé récemment
S’applique à
ReadAllLines(String, Encoding)
- 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 lecture.
- encoding
- Encoding
Encodage appliqué au contenu du fichier.
Retours
Tableau de chaînes contenant toutes les lignes du fichier.
Exceptions
.NET Framework et .NET Core versions antérieures à 2.1 : path
est une chaîne de longueur nulle, contient uniquement des espaces blancs ou contient un ou plusieurs caractères non valides. Vous pouvez rechercher les caractères non valides à l’aide de la méthode GetInvalidPathChars().
path
a la valeur null
.
Le chemin et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système.
Le chemin spécifié n’est pas valide (par exemple, il est sur un lecteur non mappé).
Une erreur d’E/S s’est produite lors de l’ouverture du fichier.
path
a spécifié un fichier en lecture seule.
- ou -
Cette opération n'est pas prise en charge sur la plateforme actuelle.
- ou -
path
a spécifié un répertoire.
- ou -
L'appelant n'a pas l'autorisation requise.
Le fichier spécifié dans path
est introuvable.
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 du texte y est ajouté.
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 flux 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.
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
- Fichier et flux de données E/S
- Lecture de texte à partir d’un fichier
- Procédure : écrire du texte dans un fichier
- Procédure : lire et écrire dans un fichier de données créé récemment