FileSystem.WriteAllBytes(String, Byte[], Boolean) Metodo

Definizione

Spazio dei nomi:

Microsoft.VisualBasic.FileIO

Assembly:

Microsoft.VisualBasic.Core.dll

Source:

FileSystem.vb

Scrive dati in un file binario.

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)

Parametri

file

String

Percorso e nome del file in cui scrivere.

data

Byte[]

Dati da scrivere nel file.

append

Boolean

True per aggiungere i dati al contenuto del file; False per sovrascrivere il contenuto del file. Il valore predefinito è False.

Eccezioni

ArgumentException

Il percorso non è valido per uno dei motivi seguenti: è una stringa di lunghezza zero; contiene solo spazi vuoti; contiene caratteri non validi; o è un percorso del dispositivo (inizia con \\.\); termina con una barra finale.

ArgumentNullException

file è Nothing.

FileNotFoundException

Il file specificato non esiste.

IOException

Il file è in uso in un altro processo oppure si verifica un errore di I/O.

PathTooLongException

La lunghezza del percorso supera la lunghezza massima definita dal sistema.

NotSupportedException

Nel nome di un file o di una directory del percorso sono presenti i due punti (:) oppure il relativo formato non è valido.

OutOfMemoryException

La memoria disponibile non è sufficiente per la scrittura della stringa nel buffer.

SecurityException

L'utente non dispone delle autorizzazioni necessarie per visualizzare il percorso.

Esempio

In questo esempio viene aggiunta la matrice CustomerData di dati al file CollectedData.

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

Commenti

Se il percorso specificato, escluso il nome del file, non è valido, verrà generata un'eccezione DirectoryNotFoundException . Se il percorso è valido, ma il file non esiste, il file viene creato.

Nota

Il WriteAllBytes metodo apre un file, lo scrive e lo chiude. Il codice che usa il WriteAllBytes metodo è più semplice del codice che usa un BinaryWriter oggetto. Tuttavia, se si aggiungono dati a un file usando un ciclo, un BinaryWriter oggetto può offrire prestazioni migliori perché è necessario aprire e chiudere il file una sola volta.

La tabella seguente elenca un esempio di un'attività che coinvolge il My.Computer.FileSystem.WriteAllBytes metodo .

A	Vedere
Scrivere in un file binario	Procedura: scrivere all'interno di file binari in Visual Basic