FileSystem.ReadAllText Método

Definição

Namespace:
Microsoft.VisualBasic.FileIO
Assembly:
Microsoft.VisualBasic.dll

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

Sobrecargas

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

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 a 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 caracteres de comprimento zero; ele contém apenas espaço em branco; ele contém caracteres inválidos; ou é um caminho do dispositivo (começa com \\.\); termina com uma barra à direita.

ArgumentNullException

file é Nothing.

FileNotFoundException

O arquivo não existe.

IOException

O arquivo está em uso por outro processo ou ocorre um erro de E/S.

PathTooLongException

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

NotSupportedException

Um nome de arquivo ou 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 permissões necessárias para exibir o caminho.

Exemplos

Este exemplo lê o conteúdo de uma cadeia de Test.txt caracteres e a exibe 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 ReadAllText método do My.Computer.FileSystem objeto permite que você leia de 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 origem do Visual Basic. Verifique todas as entradas antes de usar os dados em seu aplicativo.

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

Para Veja
Ler de um arquivo de texto How to: Read From Text Files in Visual Basic

Confira também

Aplica-se a

ReadAllText(String, Encoding)

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 a ser lido.

encoding
Encoding

Codificação de caracteres a ser usada na leitura do arquivo. O 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 caracteres de comprimento zero; ele contém apenas espaço em branco; ele contém caracteres inválidos; ou é um caminho do dispositivo (começa com \\.\); termina com uma barra à direita.

ArgumentNullException

file é Nothing.

FileNotFoundException

O arquivo não existe.

IOException

O arquivo está em uso por outro processo ou ocorre um erro de E/S.

PathTooLongException

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

NotSupportedException

Um nome de arquivo ou 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 permissões necessárias para exibir o caminho.

Exemplos

Este exemplo lê o conteúdo de uma cadeia de Test.txt caracteres e a exibe 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 ReadAllText método do My.Computer.FileSystem objeto permite que você leia de 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 origem do Visual Basic. Verifique todas as entradas antes de usar os dados em seu aplicativo.

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

Para Veja
Ler de um arquivo de texto How to: Read From Text Files in Visual Basic

Confira também

Aplica-se a