My.Computer.FileSystem.WriteAllBytes, méthode
Mise à jour : novembre 2007
Écrit des données dans un fichier binaire.
' Usage
My.Computer.FileSystem.WriteAllBytes(file ,data ,append)
' Declaration
Public Sub WriteAllBytes( _
ByVal file As String, _
ByVal data As Byte(), _
ByVal append As Boolean _
)
Paramètres
file
String. Chemin d'accès et nom du fichier dans lequel écrire. Obligatoire.data
Byte Données à écrire dans le fichier. Obligatoire.append
Boolean. Si besoin d'ajouter ou de remplacer des données. La valeur par défaut est False. Obligatoire.
Exceptions
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 chemin d'accès n'est pas valide, car il a la valeur Nothing ou se termine par une barre oblique inverse (\) (ArgumentNullException).
Le paramètre file pointe vers un chemin d'accès qui n'existe pas (FileNotFoundException ou DirectoryNotFoundException).
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).
L'utilisateur n'a pas les autorisations nécessaires pour afficher le chemin d'accès (SecurityException).
Notes
Si le paramètre append a la valeur True, il ajoute les données au fichier ; sinon, les données du fichier sont remplacées.
Si le chemin d'accès spécifié, à l'exclusion du nom de fichier, n'est pas valide, une exception DirectoryNotFoundException est levée. Si le chemin d'accès est valide mais que le fichier n'existe pas, ce dernier est créé.
Remarque : |
---|
La méthode WriteAllBytes ouvre un fichier, écrit dans le fichier, puis le ferme. Le code qui utilise la méthode WriteAllBytes est plus simple que le code qui utilise un objet BinaryWriter. Toutefois, si vous ajoutez des données à un fichier à l'aide d'une boucle, un objet BinaryWriter peut fournir une meilleure performance parce que vous devez seulement ouvrir et fermer le fichier une seule fois. |
Tâches
Le tableau suivant présente un exemple de tâche impliquant la méthode My.Computer.FileSystem.WriteAllBytes.
Pour |
Consultez |
---|---|
Écrire dans un fichier binaire |
Comment : écrire dans des fichiers binaires dans Visual Basic |
Exemple
Cet exemple ajoute le tableau de données CustomerData dans le fichier CollectedData.
My.Computer.FileSystem.WriteAllBytes _
("C:\MyDocuments\CustomerData", CustomerData, True)
Configuration requise
Espace de noms :Microsoft.VisualBasic.MyServices
Classe :FileSystemProxy (fournit l'accès à FileSystem)
Assembly : bibliothèque Visual Basic Runtime (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 : écrire dans des fichiers binaires dans Visual Basic