Compartilhar via


FileSystemProxy.ReadAllText Método

Definição

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)

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

Parâmetros

file
String

Nome e caminho do arquivo que será lido.

Retornos

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

Exceções

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.

file é Nothing.

O arquivo não existe.

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

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

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

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

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 o 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 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 exemplos de tarefas que envolvem o My.Computer.FileSystem.ReadAllText método .

Para Consulte
Ler de um arquivo de texto Como ler em arquivos de texto

Confira também

Aplica-se a

ReadAllText(String, Encoding)

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

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 que contém o conteúdo do arquivo.

Exceções

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.

file é Nothing.

O arquivo não existe.

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

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

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

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

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 o 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 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 exemplos de tarefas que envolvem o My.Computer.FileSystem.ReadAllText método .

Para Consulte
Ler de um arquivo de texto Como ler em arquivos de texto

Confira também

Aplica-se a