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