Partager via


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

Définition

É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 dans lequel é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

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 des espaces blancs ; elle 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.

file a la valeur Nothing.

Le fichier n'existe pas.

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

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

Un nom de fichier ou de dossier du chemin d'accès contient un signe deux-points (:) ou n'a pas un format correct.

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

L'utilisateur n'a pas les autorisations nécessaires pour afficher le chemin d'accès.

Exemples

Cet exemple montre comment ajouter le tableau CustomerData de données au fichier CollectedData.

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

Remarques

Si le chemin spécifié, à l’exception 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éé.

Notes

La WriteAllBytes méthode ouvre un fichier, y écrit, puis le ferme. Le code qui utilise la WriteAllBytes méthode est plus simple que le 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 vous n’avez qu’à ouvrir et 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 Guide pratique pour écrire dans des fichiers binaires en Visual Basic

S’applique à