FileSystem.ReadAllText Metodo

Definizione

Spazio dei nomi:

Microsoft.VisualBasic.FileIO

Assembly:

Microsoft.VisualBasic.Core.dll

Restituisce il contenuto di un file di testo come String.

Overload

ReadAllText(String)	Restituisce il contenuto di un file di testo come String.
ReadAllText(String, Encoding)	Restituisce il contenuto di un file di testo come String.

ReadAllText(String)

Source:

FileSystem.vb

Restituisce il contenuto di un file di testo come String.

public:
 static System::String ^ ReadAllText(System::String ^ file);

public static string ReadAllText (string file);

static member ReadAllText : string -> string

Public Shared Function ReadAllText (file As String) As String

Parametri

file

String

Nome e percorso del file da leggere.

Restituisce

String

String contenente i contenuti del file.

Eccezioni

ArgumentException

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.

ArgumentNullException

file è Nothing.

FileNotFoundException

Il file specificato non esiste.

IOException

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

PathTooLongException

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

NotSupportedException

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

OutOfMemoryException

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

SecurityException

L'utente non dispone delle autorizzazioni necessarie per visualizzare il percorso.

Esempio

Questo esempio legge il contenuto di in una stringa e quindi lo visualizza in una finestra di Test.txt messaggio.

Dim reader = My.Computer.FileSystem.ReadAllText("C:\test.txt")
MsgBox(reader)

Questo esempio legge il contenuto del file Test.txt ASCII in una stringa e quindi lo visualizza in una finestra di messaggio.

Dim reader = My.Computer.FileSystem.ReadAllText("C:\test.txt",
   System.Text.Encoding.ASCII)
MsgBox(reader)

Commenti

Il metodo ReadAllText dell'oggetto My.Computer.FileSystem consente la lettura di un file di testo. Il contenuto del file viene restituito come stringa.

La codifica file può essere specificata se il contenuto del file si trova in una codifica, ad esempio ASCII o UTF-8. Se si legge da un file con caratteri estesi, è necessario specificare la codifica del file usando un altro overload del ReadAllText metodo.

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.

La tabella seguente elenca un esempio di un'attività che coinvolge il My.Computer.FileSystem.ReadAllText metodo .

A	Vedere
Leggere da un file di testo	Procedura: leggere da file di testo in Visual Basic

Vedi anche

• Encoding
• ReadAllText
• StreamReader(Stream, Encoding)

ReadAllText(String, Encoding)

Source:

FileSystem.vb

Restituisce il contenuto di un file di testo come String.

public:
 static System::String ^ ReadAllText(System::String ^ file, System::Text::Encoding ^ encoding);

public static string ReadAllText (string file, System.Text.Encoding encoding);

static member ReadAllText : string * System.Text.Encoding -> string

Public Shared Function ReadAllText (file As String, encoding As Encoding) As String

Parametri

file

String

Nome e percorso del file da leggere.

encoding

Encoding

Codifica dei caratteri da utilizzare nella lettura del file. L'impostazione predefinita è UTF-8.

Restituisce

String

String contenente i contenuti del file.

Eccezioni

ArgumentException

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.

ArgumentNullException

file è Nothing.

FileNotFoundException

Il file specificato non esiste.

IOException

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

PathTooLongException

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

NotSupportedException

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

OutOfMemoryException

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

SecurityException

L'utente non dispone delle autorizzazioni necessarie per visualizzare il percorso.

Esempio

Questo esempio legge il contenuto di in una stringa e quindi lo visualizza in una finestra di Test.txt messaggio.

Dim reader = My.Computer.FileSystem.ReadAllText("C:\test.txt")
MsgBox(reader)

Questo esempio legge il contenuto del file Test.txt ASCII in una stringa e quindi lo visualizza in una finestra di messaggio.

Dim reader = My.Computer.FileSystem.ReadAllText("C:\test.txt",
   System.Text.Encoding.ASCII)
MsgBox(reader)

Commenti

Il metodo ReadAllText dell'oggetto My.Computer.FileSystem consente la lettura di un file di testo. Il contenuto del file viene restituito come stringa.

La codifica file può essere specificata se il contenuto del file si trova in una codifica, ad esempio ASCII o UTF-8. Se si legge da 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.

La tabella seguente elenca un esempio di un'attività che coinvolge il My.Computer.FileSystem.ReadAllText metodo .

A	Vedere
Leggere da un file di testo	Procedura: leggere da file di testo in Visual Basic

Vedi anche

• Encoding
• StreamReader(Stream, Encoding)