FileSystemProxy.WriteAllBytes(String, Byte[], Boolean) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 -> unitPublic 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 |
