FileSystemProxy.ReadAllText Metodo

Definizione

Spazio dei nomi:
Microsoft.VisualBasic.MyServices
Assembly:
Microsoft.VisualBasic.dll

Restituisce il contenuto di un file di testo come .String

Overload

Nome Descrizione
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)

Restituisce il contenuto di un file di testo come .String

public:
 System::String ^ ReadAllText(System::String ^ file);
public string ReadAllText(string file);
member this.ReadAllText : string -> string
Public Function ReadAllText (file As String) As String

Parametri

file
String

Nome e percorso del file da leggere.

Valori restituiti

String

String contenente il contenuto del file.

Eccezioni

ArgumentException

Il percorso non è valido per uno dei motivi seguenti: si tratta di 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 non esiste.

IOException

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

PathTooLongException

Il percorso supera la lunghezza massima definita dal sistema.

NotSupportedException

Un nome di file o directory nel percorso contiene due punti (:) o è in un formato non valido.

OutOfMemoryException

Memoria insufficiente per scrivere la stringa nel buffer.

SecurityException

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

Esempio

Questo esempio legge il contenuto di Test.txt in una stringa e quindi lo visualizza in una finestra di 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 ReadAllText metodo dell'oggetto My.Computer.FileSystem consente di leggere da un file di testo. Il contenuto del file viene restituito come stringa.

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

Non prendere decisioni sul contenuto del file in base al nome del file. Ad esempio, il file Form1.vb potrebbe non essere un file di origine di Visual Basic. Verificare tutti gli input prima di usare i dati nell'applicazione.

Nella tabella seguente sono elencati esempi di attività che coinvolgono il My.Computer.FileSystem.ReadAllText metodo .

Per Vedi
Leggere da un file di testo Procedura: Leggere da file di testo

Vedi anche

Si applica a

ReadAllText(String, Encoding)

Restituisce il contenuto di un file di testo come .String

public:
 System::String ^ ReadAllText(System::String ^ file, System::Text::Encoding ^ encoding);
public string ReadAllText(string file, System.Text.Encoding encoding);
member this.ReadAllText : string * System.Text.Encoding -> string
Public 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 usare per la lettura del file. Il valore predefinito è UTF-8.

Valori restituiti

String

String contenente il contenuto del file.

Eccezioni

ArgumentException

Il percorso non è valido per uno dei motivi seguenti: si tratta di 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 non esiste.

IOException

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

PathTooLongException

Il percorso supera la lunghezza massima definita dal sistema.

NotSupportedException

Un nome di file o directory nel percorso contiene due punti (:) o è in un formato non valido.

OutOfMemoryException

Memoria insufficiente per scrivere la stringa nel buffer.

SecurityException

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

Esempio

Questo esempio legge il contenuto di Test.txt in una stringa e quindi lo visualizza in una finestra di 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 ReadAllText metodo dell'oggetto My.Computer.FileSystem consente di leggere da un file di testo. Il contenuto del file viene restituito come stringa.

La codifica del file può essere specificata se il contenuto del file si trova in una codifica come ASCII o UTF-8. Se si legge da un file con caratteri estesi, è necessario specificare la codifica dei file.

Non prendere decisioni sul contenuto del file in base al nome del file. Ad esempio, il file Form1.vb potrebbe non essere un file di origine di Visual Basic. Verificare tutti gli input prima di usare i dati nell'applicazione.

Nella tabella seguente sono elencati esempi di attività che coinvolgono il My.Computer.FileSystem.ReadAllText metodo .

Per Vedi
Leggere da un file di testo Procedura: Leggere da file di testo

Vedi anche

Si applica a