Condividi tramite


Metodo My.Computer.FileSystem.ReadAllBytes

Aggiornamento: novembre 2007

Restituisce il contenuto di un file come matrice di byte.

' Usage
Dim value As Byte() = My.Computer.FileSystem.ReadAllBytes(file)
' Declaration
Public Function ReadAllBytes( _
   ByVal file As String _
) As Byte()

Parametri

  • file
    String. File da leggere. Obbligatorio.

Valore restituito

Matrice di Byte contenente il contenuto del file.

Eccezioni

Le seguenti condizioni possono causare la generazione di un'eccezione:

  • 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 nome del file termina con una barra (ArgumentException).

  • Il percorso non è valido in quanto Nothing (ArgumentNullException).

  • Il file non esiste (FileNotFoundException).

  • Il file è in uso in un altro processo oppure si è verificato un errore di 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).

  • La memoria è insufficiente per scrivere la stringa nel buffer (OutOfMemoryException).

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

Note

Il metodo ReadAllBytes dell'oggetto My.Computer.FileSystem consente di leggere da un file binario. Il contenuto del file viene restituito come matrice di byte.

Non basarsi sul nome del file per prendere decisioni in merito al relativo contenuto. È possibile ad esempio che il file Form1.vb non sia un file di origine di Visual Basic. Prima di usare i dati nell'applicazione verificare tutti gli input.

Attività

Nella tabella riportata di seguito sono elencati esempi di attività relative al metodo My.Computer.FileSystem.ReadAllBytes.

Per

Vedere

Leggere da un file binario.

Procedura: leggere da file binari in Visual Basic

Esempio

Nell'esempio viene letto il file C:/Documents and Settings/selfportrait.jpg..

My.Computer.FileSystem.ReadAllBytes _
("C:/Documents and Settings/selfportrait.jpg")

Requisiti

Spazio dei nomi:Microsoft.VisualBasic.MyServices

Classe:FileSystemProxy (fornisce accesso a FileSystem)

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

Disponibilità per tipo di progetto

Tipo di progetto

Disponibile

Applicazione Windows

Libreria di classi

Applicazione di console

Libreria di controlli Windows

Libreria di controlli Web

Servizio Windows

Sito Web

Autorizzazioni

Può essere necessaria l'autorizzazione seguente:

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

Riferimenti

Oggetto My.Computer.FileSystem

ReadAllBytes

Altre risorse

Lettura da file in Visual Basic