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.

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

Autorisations

L'autorisation suivante peut être nécessaire.

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

Référence

My.Computer.FileSystem, objet

WriteAllBytes

Autres ressources

Écriture dans des fichiers en Visual Basic