Metodo My.Computer.FileSystem.ReadAllText
Aggiornamento: novembre 2007
Restituisce il contenuto di un file di testo come String.
' Usage
Dim value As String = My.Computer.FileSystem.ReadAllText(file)
Dim value As String = My.Computer.FileSystem.ReadAllText(file ,encoding)
' Declaration
Public Function ReadAllText( _
ByVal file As String _
) As String
' -or-
Public Function ReadAllText( _
ByVal file As String, _
ByVal encoding As System.Text.Encoding _
) As String
Parametri
file
String. Nome e percorso del file da leggere. Obbligatorio.encoding
System.Text.Encoding. Codifica dei caratteri da utilizzare per la lettura del file. Obbligatorio. Il valore predefinito è UTF-8.
Valore restituito
String che include i contenuti del file.
Eccezioni
È possibile che il contenuto del file non corrisponda a quanto previsto e che quindi i metodi per la lettura dal file non abbiano esito positivo.
Le seguenti condizioni possono generare 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 finale (ArgumentException).
Il percorso non è valido in quanto Nothing (ArgumentNullException).
Il file non esiste (FileNotFoundException).
Il file è in uso in un altro processo o 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 disponibile non è sufficiente per la stringa da scrivere nel buffer (OutOfMemoryException).
L'utente non dispone delle autorizzazioni necessarie per visualizzare il percorso (SecurityException).
Note
Il metodo ReadAllText dell'oggetto My.Computer.FileSystem consente la lettura di un file di testo. Il contenuto del file viene restituito come stringa.
È possibile specificare la codifica del file se il contenuto è codificato in ASCII o UTF-8. Se viene letto un file con caratteri estesi, è necessario specificare la codifica del file.
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.ReadAllText.
Per |
Vedere |
|---|---|
Leggere da un file di testo. |
Esempio
Nell'esempio seguente il contenuto di Test.txt viene letto in una stringa e quindi visualizzato in una finestra di messaggio.
Dim reader As String
reader = My.Computer.FileSystem.ReadAllText("C:\test.txt")
MsgBox(reader)
Nell'esempio seguente il contenuto del file ASCII Test.txt viene letto in una stringa e quindi visualizzato in una finestra di messaggio.
Dim reader As String
reader = My.Computer.FileSystem.ReadAllText("C:\test.txt", _
System.Text.Encoding.ASCII)
MsgBox(reader)
Requisiti
Spazio dei nomi:Microsoft.VisualBasic.MyServices
Classe:FileSystemProxy (fornisce l'accesso a FileSystem)
Assembly: 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
Può essere necessaria l'autorizzazione seguente:
Autorizzazione |
Descrizione |
|---|---|
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: leggere il testo di un file con uno StreamReader (Visual Basic)
Risoluzione dei problemi: lettura e scrittura nei file di testo
Procedura dettagliata: modifica di file e directory in Visual Basic
Concetti
Riferimenti
Oggetto My.Computer.FileSystem