Condividi tramite


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

Definizione

Scrive dati in un file binario.

public:
 void WriteAllBytes(System::String ^ file, cli::array <System::Byte> ^ data, bool append);
public void WriteAllBytes (string file, byte[] data, bool append);
member this.WriteAllBytes : string * byte[] * bool -> unit
Public 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

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.

file è Nothing.

Il file specificato non esiste.

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

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

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

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

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 in file binari

Si applica a

Vedi anche