FileSystem.ReadAllText Método

Definição

Espaço de Nomes:
Microsoft.VisualBasic.FileIO
Assemblagem:
Microsoft.VisualBasic.dll

Devolve o conteúdo de um ficheiro de texto como um String.

Sobrecargas

Name Description
ReadAllText(String)

Devolve o conteúdo de um ficheiro de texto como um String.
ReadAllText(String, Encoding)

Devolve o conteúdo de um ficheiro de texto como um String.

ReadAllText(String)

Devolve o conteúdo de um ficheiro de texto como um 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

Parâmetros

file
String

Nome e caminho do ficheiro a ler.

Devoluções

String

String contendo o conteúdo do ficheiro.

Exceções

ArgumentException

O caminho não é válido por uma das seguintes razões: é uma cadeia de comprimento zero; contém apenas espaço em branco; contém caracteres inválidos; ou é um caminho de dispositivo (começa por \\.\); termina com um corte de arrasto.

ArgumentNullException

file é Nothing.

FileNotFoundException

O ficheiro não existe.

IOException

O ficheiro é utilizado por outro processo, ou ocorre um erro de E/S.

PathTooLongException

O percurso excede o comprimento máximo definido pelo sistema.

NotSupportedException

Um nome de ficheiro ou diretório no caminho contém dois pontos (:) ou está num formato inválido.

OutOfMemoryException

Não há memória suficiente para escrever a string para buffer.

SecurityException

O utilizador não tem as permissões necessárias para visualizar o caminho.

Exemplos

Este exemplo lê o conteúdo de Test.txt numa cadeia e depois exibe-o numa caixa de mensagem.

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

Este exemplo lê o conteúdo do ficheiro Test.txt ASCII numa cadeia e depois apresenta-o numa caixa de mensagem.

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

Observações

O ReadAllText método do My.Computer.FileSystem objeto permite que você leia a partir de um arquivo de texto. O conteúdo do ficheiro é devolvido como uma cadeia.

A codificação do ficheiro pode ser especificada se o conteúdo do ficheiro estiver numa codificação como ASCII ou UTF-8. Se estiver a ler de um ficheiro com caracteres estendidos, precisa de especificar a codificação do ficheiro usando outra sobrecarga do ReadAllText método.

Não tome decisões sobre o conteúdo do arquivo com base no nome do arquivo. Por exemplo, o arquivo Form1.vb pode não ser um arquivo de origem do Visual Basic. Verifique todas as entradas antes de usar os dados em seu aplicativo.

A tabela seguinte apresenta um exemplo de uma tarefa envolvendo o My.Computer.FileSystem.ReadAllText método.

Para Veja
Ler a partir de um ficheiro de texto Como: ler de ficheiros de texto em Visual Basic

Ver também

Aplica-se a

ReadAllText(String, Encoding)

Devolve o conteúdo de um ficheiro de texto como um 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

Parâmetros

file
String

Nome e caminho do ficheiro a ler.

encoding
Encoding

Codificação de caracteres para usar na leitura do ficheiro. O padrão é UTF-8.

Devoluções

String

String contendo o conteúdo do ficheiro.

Exceções

ArgumentException

O caminho não é válido por uma das seguintes razões: é uma cadeia de comprimento zero; contém apenas espaço em branco; contém caracteres inválidos; ou é um caminho de dispositivo (começa por \\.\); termina com um corte de arrasto.

ArgumentNullException

file é Nothing.

FileNotFoundException

O ficheiro não existe.

IOException

O ficheiro é utilizado por outro processo, ou ocorre um erro de E/S.

PathTooLongException

O percurso excede o comprimento máximo definido pelo sistema.

NotSupportedException

Um nome de ficheiro ou diretório no caminho contém dois pontos (:) ou está num formato inválido.

OutOfMemoryException

Não há memória suficiente para escrever a string para buffer.

SecurityException

O utilizador não tem as permissões necessárias para visualizar o caminho.

Exemplos

Este exemplo lê o conteúdo de Test.txt numa cadeia e depois exibe-o numa caixa de mensagem.

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

Este exemplo lê o conteúdo do ficheiro Test.txt ASCII numa cadeia e depois apresenta-o numa caixa de mensagem.

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

Observações

O ReadAllText método do My.Computer.FileSystem objeto permite que você leia a partir de um arquivo de texto. O conteúdo do ficheiro é devolvido como uma cadeia.

A codificação do ficheiro pode ser especificada se o conteúdo do ficheiro estiver numa codificação como ASCII ou UTF-8. Se estiver a ler a partir de um ficheiro com caracteres estendidos, precisa de especificar a codificação do ficheiro.

Não tome decisões sobre o conteúdo do arquivo com base no nome do arquivo. Por exemplo, o arquivo Form1.vb pode não ser um arquivo de origem do Visual Basic. Verifique todas as entradas antes de usar os dados em seu aplicativo.

A tabela seguinte apresenta um exemplo de uma tarefa envolvendo o My.Computer.FileSystem.ReadAllText método.

Para Veja
Ler a partir de um ficheiro de texto Como: ler de ficheiros de texto em Visual Basic

Ver também

Aplica-se a