Partager via


FileSystemProxy.ReadAllText Méthode

Définition

Retourne le contenu d'un fichier texte sous forme de String.

Surcharges

ReadAllText(String)

Retourne le contenu d'un fichier texte sous forme de String.

ReadAllText(String, Encoding)

Retourne le contenu d'un fichier texte sous forme de String.

ReadAllText(String)

Retourne le contenu d'un fichier texte sous forme de String.

public:
 System::String ^ ReadAllText(System::String ^ file);
public string ReadAllText (string file);
member this.ReadAllText : string -> string
Public Function ReadAllText (file As String) As String

Paramètres

file
String

Nom et chemin d'accès du fichier à lire.

Retours

String contenant le contenu du fichier.

Exceptions

Le chemin d’accès n’est pas valide pour l’une des raisons suivantes : il s’agit d’une chaîne de longueur nulle ; il ne contient que des espaces blancs ; il contient des caractères non valides ; ou il s’agit d’un chemin d’appareil (commence par \\.\) ; il se termine par une barre oblique de fin.

file a la valeur Nothing.

Le fichier n'existe pas.

Le fichier est utilisé par un autre processus ou une erreur d'E/S se produit.

Le chemin d'accès dépasse la longueur maximale définie par le système.

Un nom de fichier ou de dossier du chemin d'accès contient un signe deux-points (:) ou n'a pas un format correct.

Il n'y a pas assez de mémoire pour écrire la chaîne dans la mémoire tampon.

L'utilisateur n'a pas les autorisations nécessaires pour afficher le chemin d'accès.

Exemples

Cet exemple lit le contenu de Test.txt dans une chaîne, puis l’affiche dans une zone de message.

Dim reader = My.Computer.FileSystem.ReadAllText("C:\test.txt")
MsgBox(reader)

Cet exemple lit le contenu du fichier Test.txt ASCII dans une chaîne, puis l’affiche dans une zone de message.

Dim reader = My.Computer.FileSystem.ReadAllText("C:\test.txt",
   System.Text.Encoding.ASCII)
MsgBox(reader)

Remarques

La méthode ReadAllText de l'objet My.Computer.FileSystem vous permet de lire un fichier texte. Le contenu du fichier est retourné sous forme de chaîne.

L’encodage de fichier peut être spécifié si le contenu du fichier se trouve dans un encodage tel que ASCII ou UTF-8. Si vous lisez à partir d’un fichier avec des caractères étendus, vous devez spécifier l’encodage du fichier à l’aide d’une autre surcharge de la ReadAllText méthode.

Ne vous basez pas sur le nom d'un fichier pour en déterminer le contenu. Par exemple, le fichier Form1.vb peut ne pas être un fichier source Visual Basic. Vérifiez toutes les entrées avant d'utiliser les données dans votre application.

Le tableau suivant répertorie des exemples de tâches impliquant la My.Computer.FileSystem.ReadAllText méthode.

À Consultez
Lire à partir d'un fichier texte Guide pratique : lire à partir de fichiers texte

Voir aussi

S’applique à

ReadAllText(String, Encoding)

Retourne le contenu d'un fichier texte sous forme de String.

public:
 System::String ^ ReadAllText(System::String ^ file, System::Text::Encoding ^ encoding);
public string ReadAllText (string file, System.Text.Encoding encoding);
member this.ReadAllText : string * System.Text.Encoding -> string
Public Function ReadAllText (file As String, encoding As Encoding) As String

Paramètres

file
String

Nom et chemin d'accès du fichier à lire.

encoding
Encoding

Encodage de caractères à utiliser pour la lecture du fichier. La valeur par défaut est UTF-8.

Retours

String contenant le contenu du fichier.

Exceptions

Le chemin d’accès n’est pas valide pour l’une des raisons suivantes : il s’agit d’une chaîne de longueur nulle ; il ne contient que des espaces blancs ; il contient des caractères non valides ; ou il s’agit d’un chemin d’appareil (commence par \\.\) ; il se termine par une barre oblique de fin.

file a la valeur Nothing.

Le fichier n'existe pas.

Le fichier est utilisé par un autre processus ou une erreur d'E/S se produit.

Le chemin d'accès dépasse la longueur maximale définie par le système.

Un nom de fichier ou de dossier du chemin d'accès contient un signe deux-points (:) ou n'a pas un format correct.

Il n'y a pas assez de mémoire pour écrire la chaîne dans la mémoire tampon.

L'utilisateur n'a pas les autorisations nécessaires pour afficher le chemin d'accès.

Exemples

Cet exemple lit le contenu de Test.txt dans une chaîne, puis l’affiche dans une zone de message.

Dim reader = My.Computer.FileSystem.ReadAllText("C:\test.txt")
MsgBox(reader)

Cet exemple lit le contenu du fichier Test.txt ASCII dans une chaîne, puis l’affiche dans une zone de message.

Dim reader = My.Computer.FileSystem.ReadAllText("C:\test.txt",
   System.Text.Encoding.ASCII)
MsgBox(reader)

Remarques

La méthode ReadAllText de l'objet My.Computer.FileSystem vous permet de lire un fichier texte. Le contenu du fichier est retourné sous forme de chaîne.

L’encodage de fichier peut être spécifié si le contenu du fichier se trouve dans un encodage tel que ASCII ou UTF-8. Si vous lisez à partir d’un fichier avec des caractères étendus, vous devez spécifier l’encodage du fichier.

Ne vous basez pas sur le nom d'un fichier pour en déterminer le contenu. Par exemple, le fichier Form1.vb peut ne pas être un fichier source Visual Basic. Vérifiez toutes les entrées avant d'utiliser les données dans votre application.

Le tableau suivant répertorie des exemples de tâches impliquant la My.Computer.FileSystem.ReadAllText méthode.

À Consultez
Lire à partir d'un fichier texte Guide pratique : lire à partir de fichiers texte

Voir aussi

S’applique à