Partager via


My.Computer.FileSystem.ReadAllBytes, méthode

Mise à jour : novembre 2007

Retourne le contenu d'un fichier sous forme de tableau d'octets.

' Usage
Dim value As Byte() = My.Computer.FileSystem.ReadAllBytes(file)
' Declaration
Public Function ReadAllBytes( _
   ByVal file As String _
) As Byte()

Paramètres

  • file
    String. Fichier à lire. Obligatoire.

Valeur de retour

Tableau Byte qui contient le contenu du fichier.

Exceptions

Les conditions ci-dessous peuvent lever 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 ReadAllBytes de l'objet My.Computer.FileSystem vous permet de lire un fichier binaire. Le contenu du fichier est retourné sous forme de tableau d'octets.

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.ReadAllBytes.

Pour

Consultez

Lire un fichier binaire

Comment : lire des fichiers binaires dans Visual Basic

Exemple

Cet exemple lit le fichier C:/Documents and Settings/selfportrait.jpg.

My.Computer.FileSystem.ReadAllBytes _
("C:/Documents and Settings/selfportrait.jpg")

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

FileIOPermission

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

Référence

My.Computer.FileSystem, objet

ReadAllBytes

Autres ressources

Lecture à partir de fichiers en Visual Basic