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
| 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
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
- E/S de fichier et de flux
- lecture de texte à partir d’un fichier
- Guide pratique pour écrire du texte dans un fichier
- Guide pratique pour lire et écrire dans un fichier de données nouvellement créé
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
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
- E/S de fichier et de flux
- lecture de texte à partir d’un fichier
- Guide pratique pour écrire du texte dans un fichier
- Guide pratique pour lire et écrire dans un fichier de données nouvellement créé