FileSystem.WriteAllBytes(String, Byte[], Boolean) Méthode

Définition

Espace de noms:

Microsoft.VisualBasic.FileIO

Assembly:

Microsoft.VisualBasic.dll

Écrit des données dans un fichier binaire.

public:
 static void WriteAllBytes(System::String ^ file, cli::array <System::Byte> ^ data, bool append);

public static void WriteAllBytes(string file, byte[] data, bool append);

static member WriteAllBytes : string * byte[] * bool -> unit

Public Shared Sub WriteAllBytes (file As String, data As Byte(), append As Boolean)

Paramètres

file

String

Chemin d’accès et nom du fichier à écrire.

data

Byte[]

Données à écrire dans le fichier.

append

Boolean

True pour ajouter au contenu du fichier ; False pour remplacer le contenu du fichier. La valeur par défaut est False.

Exceptions

ArgumentException

Le chemin d’accès n’est pas valide pour l’une des raisons suivantes : il s’agit d’une chaîne de longueur nulle ; il contient uniquement de l’espace blanc ; contient des caractères non valides ; ou il s’agit d’un chemin d’accès d’appareil (commence par \\.\) ; il se termine par une barre oblique de fin.

ArgumentNullException

file a la valeur Nothing.

FileNotFoundException

Le fichier n’existe pas.

IOException

Le fichier est utilisé par un autre processus ou une erreur d’E/S se produit.

PathTooLongException

Le chemin dépasse la longueur maximale définie par le système.

NotSupportedException

Un nom de fichier ou de répertoire dans le chemin contient un signe deux-points (:) ou est dans un format non valide.

OutOfMemoryException

Il n’y a pas suffisamment de mémoire pour écrire la chaîne dans la mémoire tampon.

SecurityException

L’utilisateur ne dispose pas des autorisations nécessaires pour afficher le chemin d’accès.

Exemples

Cet exemple ajoute le tableau CustomerData de données au fichier CollectedData.

My.Computer.FileSystem.WriteAllBytes(
  "C:\MyDocuments\CustomerData", CustomerData, True)

Remarques

Si le chemin d’accès spécifié, à l’exclusion du nom de fichier, n’est pas valide, une DirectoryNotFoundException exception est levée. Si le chemin d’accès est valide mais que le fichier n’existe pas, le fichier est créé.

Note

La WriteAllBytes méthode ouvre un fichier, y écrit, puis le ferme. Le code qui utilise la méthode est plus simple que le WriteAllBytes code qui utilise un BinaryWriter objet. Toutefois, si vous ajoutez des données à un fichier à l’aide d’une boucle, un BinaryWriter objet peut fournir de meilleures performances, car il vous suffit d’ouvrir et de fermer le fichier une seule fois.

Le tableau suivant répertorie un exemple de tâche impliquant la My.Computer.FileSystem.WriteAllBytes méthode.

À	Consultez
Écrire dans un fichier binaire	How to : Write to Binary Files in Visual Basic