Condividi tramite


FileSystemProxy.ReadAllText Metodo

Definizione

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)

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.

Restituisce

String contenente i contenuti del file.

Eccezioni

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.

file è Nothing.

Il file specificato non esiste.

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

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

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

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

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.

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

A Vedere
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 utilizzare nella lettura del file. L'impostazione predefinita è UTF-8.

Restituisce

String contenente i contenuti del file.

Eccezioni

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.

file è Nothing.

Il file specificato non esiste.

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

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

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

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

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.

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

A Vedere
Leggere da un file di testo Procedura: Leggere da file di testo

Vedi anche

Si applica a