Condividi tramite

Metodo My.Computer.FileSystem.WriteAllBytes

  • Articolo

Aggiornamento: novembre 2007

Consente di scrivere i dati in un file binario.

' Usage
My.Computer.FileSystem.WriteAllBytes(file ,data ,append)
' Declaration
Public Sub WriteAllBytes( _
   ByVal file As String, _
   ByVal data As Byte(), _
   ByVal append As Boolean _
)

Parametri

  • file
    String. Percorso e nome del file nel quale scrivere. Obbligatorio.

  • data
    Byte. Dati da scrivere nel file. Obbligatorio.

  • append
    Boolean. Aggiungere o sovrascrivere i dati. Il valore predefinito è False. Obbligatorio.

Eccezioni

Un'eccezione può essere generata nelle condizioni seguenti:

  • Il percorso non è valido per uno dei seguenti motivi: è una stringa di lunghezza zero; contiene solo spazi vuoti; contiene caratteri non validi o è il percorso di una periferica, vale a dire inizia con \\.\) (ArgumentException).

  • Il percorso non è valido in quanto è Nothing o termina con una barra rovesciata (\) (ArgumentNullException).

  • Il parametro file indica un percorso che non esiste (FileNotFoundException o DirectoryNotFoundException).

  • Il file viene utilizzato da un altro processo o si verifica un errore I/O (IOException).

  • La lunghezza del percorso supera la lunghezza massima definita dal sistema (PathTooLongException).

  • Un nome di file o di directory nel percorso contiene i due punti (:) o ha un formato non valido (NotSupportedException).

  • L'utente non dispone delle autorizzazioni necessarie per visualizzare il percorso (SecurityException).

Note

Se il parametro append è True, i dati verranno aggiunti al file. In caso contrario i dati nel file verranno sovrascritti.

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

Nota:

Il metodo WriteAllBytes apre un file, scrive e quindi lo chiude. Il codice che utilizza il metodo WriteAllBytes è più semplice del codice che utilizza un oggetto BinaryWriter. Tuttavia, se si stanno aggiungendo dati a un file utilizzando un ciclo, un oggetto BinaryWriter può fornire prestazioni migliori perché deve solo aprire e chiudere una volta il file.

Attività

Nella tabella riportata di seguito viene elencato un esempio di un'attività relativa al metodo My.Computer.FileSystem.WriteAllBytes.

Per

Vedere

Scrivere in un file binario

Procedura: scrivere all'interno di file binari in Visual Basic

Esempio

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

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

Requisiti

Spazio dei nomi:Microsoft.VisualBasic.MyServices

Classe:FileSystemProxy (fornisce accesso a FileSystem)

Assembly: la libreria di runtime di Visual Basic (in Microsoft.VisualBasic.dll)

Disponibilità in base al tipo di progetto

Tipo di progetto

Disponibile

Applicazione Windows

Sì

Libreria di classi

Sì

Applicazione di console

Sì

Libreria di controlli Windows

Sì

Libreria di controllo Web

Sì

Servizio Windows

Sì

Sito Web

Sì

Autorizzazioni

Potrebbero essere necessarie le seguenti autorizzazioni:

Autorizzazione

Descrizione

FileIOPermission

Controlla la possibilità di accedere ai file e alle cartelle. Enumerazione associata: Unrestricted.

Per ulteriori informazioni, vedere Protezione dall'accesso di codice e Richiesta di autorizzazioni.

Vedere anche

Attività

Procedura: scrivere all'interno di file binari in Visual Basic

Riferimenti

Oggetto My.Computer.FileSystem

WriteAllBytes

Altre risorse

Scrittura su file in Visual Basic