FileSystem.ReadAllText Método

Definição

Namespace:

Microsoft.VisualBasic.FileIO

Assembly:

Microsoft.VisualBasic.Core.dll

Retorna o conteúdo de um arquivo de texto como um String.

Sobrecargas

ReadAllText(String)	Retorna o conteúdo de um arquivo de texto como um String.
ReadAllText(String, Encoding)	Retorna o conteúdo de um arquivo de texto como um String.

ReadAllText(String)

Origem:

FileSystem.vb

Retorna o conteúdo de um arquivo 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 arquivo que será lido.

Retornos

String

String que contém o conteúdo do arquivo.

Exceções

ArgumentException

O caminho não é válido por um dos seguintes motivos: é uma cadeia de comprimento zero, contém apenas espaços em branco, contém caracteres inválidos ou é um caminho de dispositivo (começa com \\.\); ele termina com uma barra à direita.

ArgumentNullException

file é Nothing.

FileNotFoundException

O arquivo não existe.

IOException

O arquivo está sendo usado por outro processo, ou ocorre um erro de E/S.

PathTooLongException

O caminho excede o tamanho máximo definido pelo sistema.

NotSupportedException

Um nome de arquivo ou de diretório no caminho contém dois-pontos (:) ou está em um formato inválido.

OutOfMemoryException

Não há memória suficiente para gravar a cadeia de caracteres no buffer.

SecurityException

O usuário não tem as permissões necessárias para exibir o caminho.

Exemplos

Este exemplo lê o conteúdo de em uma cadeia de Test.txt caracteres e, em seguida, exibe-o em uma caixa de mensagem.

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

Este exemplo lê o conteúdo do arquivo Test.txt ASCII em uma cadeia de caracteres e o exibe em uma caixa de mensagem.

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

Comentários

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

A codificação de arquivo poderá ser especificada se o conteúdo do arquivo estiver em uma codificação como ASCII ou UTF-8. Se você estiver lendo de um arquivo com caracteres estendidos, precisará especificar a codificação de arquivo 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 código-fonte do Visual Basic. Verifique todas as entradas antes de usar os dados no seu aplicativo.

A tabela a seguir lista um exemplo de uma tarefa envolvendo o My.Computer.FileSystem.ReadAllText método .

Para	Consulte
Ler de um arquivo de texto	Como ler a partir de arquivos de texto no Visual Basic

Confira também

• Encoding
• ReadAllText
• StreamReader(Stream, Encoding)

ReadAllText(String, Encoding)

Origem:

FileSystem.vb

Retorna o conteúdo de um arquivo 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 arquivo que será lido.

encoding

Encoding

A codificação de caracteres a ser usada na leitura do arquivo. Padrão é UTF-8.

Retornos

String

String que contém o conteúdo do arquivo.

Exceções

ArgumentException

O caminho não é válido por um dos seguintes motivos: é uma cadeia de comprimento zero, contém apenas espaços em branco, contém caracteres inválidos ou é um caminho de dispositivo (começa com \\.\); ele termina com uma barra à direita.

ArgumentNullException

file é Nothing.

FileNotFoundException

O arquivo não existe.

IOException

O arquivo está sendo usado por outro processo, ou ocorre um erro de E/S.

PathTooLongException

O caminho excede o tamanho máximo definido pelo sistema.

NotSupportedException

Um nome de arquivo ou de diretório no caminho contém dois-pontos (:) ou está em um formato inválido.

OutOfMemoryException

Não há memória suficiente para gravar a cadeia de caracteres no buffer.

SecurityException

O usuário não tem as permissões necessárias para exibir o caminho.

Exemplos

Este exemplo lê o conteúdo de em uma cadeia de Test.txt caracteres e, em seguida, exibe-o em uma caixa de mensagem.

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

Este exemplo lê o conteúdo do arquivo Test.txt ASCII em uma cadeia de caracteres e o exibe em uma caixa de mensagem.

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

Comentários

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

A codificação de arquivo poderá ser especificada se o conteúdo do arquivo estiver em uma codificação como ASCII ou UTF-8. Se você estiver lendo de um arquivo com caracteres estendidos, precisará especificar a codificação de arquivo.

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 código-fonte do Visual Basic. Verifique todas as entradas antes de usar os dados no seu aplicativo.

A tabela a seguir lista um exemplo de uma tarefa envolvendo o My.Computer.FileSystem.ReadAllText método .

Para	Consulte
Ler de um arquivo de texto	Como ler a partir de arquivos de texto no Visual Basic

Confira também

• Encoding
• StreamReader(Stream, Encoding)