File.ReadAllText Méthode

Définition

Ouvre un fichier texte, lit tout le texte du fichier dans une chaîne, puis ferme le fichier.

Surcharges

ReadAllText(String)

Ouvre un fichier texte, lit tout le texte du fichier, puis ferme le fichier.

ReadAllText(String, Encoding)

Ouvre un fichier, lit la totalité du texte du fichier avec l’encodage spécifié, puis ferme le fichier.

ReadAllText(String)

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

Ouvre un fichier texte, lit tout le texte du fichier, puis ferme le fichier.

public:
 static System::String ^ ReadAllText(System::String ^ path);
public static string ReadAllText (string path);
static member ReadAllText : string -> string
Public Shared Function ReadAllText (path As String) As String

Paramètres

path
String

Fichier à ouvrir pour lecture.

Retours

Chaîne contenant la totalité du texte 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 ReadAllText 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" + Environment.NewLine;
            File.WriteAllText(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.ReadAllText(path);
        Console.WriteLine(readText);
    }
}
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" + Environment.NewLine

    File.WriteAllText(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.ReadAllText path
printfn $"{readText}"
Imports System.IO
Imports System.Text

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

        ' 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" + Environment.NewLine
            File.WriteAllText(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.ReadAllText(path)
        Console.WriteLine(readText)
    End Sub
End Class

Remarques

Cette méthode ouvre un fichier, lit tout le texte du fichier et le retourne sous forme de chaîne. Il ferme ensuite le fichier.

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. Il reconnaît automatiquement le texte UTF-8, UTF-16 petit-endian, big-endian UTF-16, little-endian UTF-32 et big-endian UTF-32 text si le fichier commence par les marques d’ordre d’octet appropriées.

Utilisez la surcharge de ReadAllText(String, Encoding) méthode lors de la lecture de fichiers susceptibles de contenir du texte importé, car les caractères non reconnus peuvent ne pas être lus correctement.

La fermeture du handle de fichier est garantie par cette méthode, même si des exceptions sont levées.

Voir aussi

S’applique à

ReadAllText(String, Encoding)

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

Ouvre un fichier, lit la totalité du texte du fichier avec l’encodage spécifié, puis ferme le fichier.

public:
 static System::String ^ ReadAllText(System::String ^ path, System::Text::Encoding ^ encoding);
public static string ReadAllText (string path, System.Text.Encoding encoding);
static member ReadAllText : string * System.Text.Encoding -> string
Public Shared Function ReadAllText (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

Chaîne contenant la totalité du texte 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 ReadAllText 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" + Environment.NewLine;
            File.WriteAllText(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.ReadAllText(path);
        Console.WriteLine(readText);
    }
}
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" + Environment.NewLine

    File.WriteAllText(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.ReadAllText path
printfn $"{readText}"
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" + Environment.NewLine
            File.WriteAllText(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.ReadAllText(path)
        Console.WriteLine(readText)
    End Sub
End Class

Remarques

Cette méthode ouvre un fichier, lit tout le texte du fichier et le retourne sous forme de chaîne. Il ferme ensuite le fichier.

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. Il reconnaît automatiquement le texte UTF-8, UTF-16 petit-endian, big-endian UTF-16, little-endian UTF-32 et big-endian UTF-32 text si le fichier commence par les marques d’ordre d’octet appropriées.

La fermeture du handle de fichier est garantie par cette méthode, même si des exceptions sont levées.

Pour utiliser les paramètres d’encodage configurés pour votre système d’exploitation, spécifiez la Encoding.Default propriété pour le encoding paramètre.

Voir aussi

S’applique à