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

Référence

Définition

Espace de noms:: Microsoft.VisualBasic.FileIO

Assembly:: Microsoft.VisualBasic.Core.dll

Assembly:: Microsoft.VisualBasic.dll

Source:: FileSystem.vb

Source:: FileSystem.vb

Source:: FileSystem.vb

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

É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

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

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'accès dépasse la longueur maximale définie par le système.

NotSupportedException

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

OutOfMemoryException

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

SecurityException

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 à