My.Computer.FileSystem.ReadAllText, méthode
Mise à jour : novembre 2007
Retourne le contenu d'un fichier texte sous forme de String.
' Usage
Dim value As String = My.Computer.FileSystem.ReadAllText(file)
Dim value As String = My.Computer.FileSystem.ReadAllText(file ,encoding)
' Declaration
Public Function ReadAllText( _
ByVal file As String _
) As String
' -or-
Public Function ReadAllText( _
ByVal file As String, _
ByVal encoding As System.Text.Encoding _
) As String
Paramètres
file
String. Nom et chemin d'accès du fichier à lire. Obligatoire.encoding
System.Text.Encoding. Codage de caractères à utiliser pour lire le fichier. Obligatoire. La valeur par défaut est UTF-8.
Valeur de retour
String qui contient le contenu du fichier.
Exceptions
Le fichier n'a peut-être pas le contenu attendu, et les méthodes utilisées pour lire le fichier peuvent échouer.
Les conditions ci-dessous peuvent générer une exception :
Le chemin d'accès n'est pas valide pour 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'accès de périphérique (qui commence par \\.\) (ArgumentException).
Le nom du fichier se termine par une barre oblique finale (ArgumentException).
Le chemin d'accès n'est pas valide, car il a la valeur Nothing (ArgumentNullException).
Le fichier n'existe pas (FileNotFoundException).
Le fichier est utilisé par un autre processus, ou une erreur d'E/S s'est produite (IOException).
Le chemin d'accès dépasse la longueur maximale définie par le système (PathTooLongException).
Un nom de fichier ou de répertoire du chemin d'accès contient un signe deux-points (:) ou n'a pas un format correct (NotSupportedException).
La mémoire est insuffisante pour écrire la chaîne dans la mémoire tampon (OutOfMemoryException).
L'utilisateur n'a pas les autorisations nécessaires pour afficher le chemin d'accès (SecurityException).
Notes
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.
Le codage de fichier peut être spécifié si le contenu du fichier utilise un codage ASCII ou UTF-8. Si vous lisez un fichier contenant des caractères étendus, vous devez spécifier le codage de fichier.
Ne vous basez pas sur le nom d'un fichier pour en déterminer le contenu. Par exemple, il se peut qu'un fichier nommé Form1.vb ne soit pas un fichier source Visual Basic. Vérifiez toutes les entrées avant d'utiliser les données dans votre application.
Tâches
Le tableau suivant répertorie des exemples de tâches impliquant la méthode My.Computer.FileSystem.ReadAllText.
Pour |
Consultez |
|---|---|
Lire un fichier texte. |
Exemple
Cet exemple lit le contenu de Test.txt dans une chaîne puis l'affiche dans un message.
Dim reader As String
reader = My.Computer.FileSystem.ReadAllText("C:\test.txt")
MsgBox(reader)
Cet exemple lit le contenu du fichier ASCII Test.txt dans une chaîne puis l'affiche dans un message.
Dim reader As String
reader = My.Computer.FileSystem.ReadAllText("C:\test.txt", _
System.Text.Encoding.ASCII)
MsgBox(reader)
Configuration requise
Espace de noms :Microsoft.VisualBasic.MyServices
Classe :FileSystemProxy (fournit l'accès à FileSystem)
Assembly : bibliothèque runtime Visual Basic (dans Microsoft.VisualBasic.dll)
Disponibilité par type de projet
Type de projet |
Disponible |
|---|---|
Application Windows |
Oui |
Bibliothèque de classes |
Oui |
Application console |
Oui |
Bibliothèque de contrôles Windows |
Oui |
Bibliothèque de contrôles Web |
Oui |
Service Windows |
Oui |
Site Web |
Oui |
Autorisations
L'autorisation suivante peut être nécessaire :
Autorisation |
Description |
|---|---|
Contrôle la possibilité d'accéder à des fichiers et à des dossiers. Énumération associée : Unrestricted. |
Pour plus d'informations, consultez Sécurité d'accès du code et Demande d'autorisations.
Voir aussi
Tâches
Comment : lire le texte des fichiers avec un StreamReader (Visual Basic)
Dépannage : lecture et écriture dans des fichiers texte
Procédure pas à pas : manipulation de fichiers et de répertoires en Visual Basic