Método My.Computer.FileSystem.ReadAllText
Retorna o conteúdo de um arquivo texto como uma String.
' Usage
Dim value As String = My.Computer.FileSystem.ReadAllText(file)
Dim value As String = My.Computer.FileSystem.ReadAllText(file ,encoding)
' Declaration
Public Function ReadAllText( _
ByVal file As String _
) As String
' -or-
Public Function ReadAllText( _
ByVal file As String, _
ByVal encoding As System.Text.Encoding _
) As String
Parâmetros
file
String.Nome e caminho do arquivo para leitura.Obrigatório.encoding
System.Text.Encoding.Caractere de codificação a ser usada na leitura do arquivo.Obrigatório.O padrão é UTF-8.
Valor de retorno
String com o contúdo do arquivo.
Exceções
O conteúdo do arquivo pode não ser esperado e métodos para ler o arquivo podem falhar.
As seguintes condições podem causar uma exceção:
O caminho inválido para um dos seguintes motivos: Ele é uma cadeia de comprimento zero; ele contém somente espaços em branco; ele contém caracteres inválidos; ou é um caminho de dispositivo (começa com \\.\) (ArgumentException).
O nome do arquivo termina com uma barra (ArgumentException).
O caminho não é válido porque ele é Nothing (ArgumentNullException).
O arquivo não existe (FileNotFoundException).
O arquivo está em uso por outro processo, ou ocorre um erro de I/O (IOException).
O caminho excede o comprimento máximo definido pelo sistema (PathTooLongException).
Um nome de arquivo ou de diretório no caminho contém dois-pontos (:) ou está em um formato inválido (NotSupportedException).
Não há memória suficiente para gravar a sequência de caracteres no buffer (OutOfMemoryException).
O usuário não possui permissões necessárias para exibir o caminho (SecurityException).
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 cadeia de caracteres.
A codificação do arquivo pode ser especificado se o Sumário do arquivo é uma codificação, sistema autônomo ASCII ou UTF-8.Se você estiver lendo um arquivo com caracteres estendidos, você precisará especificar a codificação do arquivo.
Não faça 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 fonte do Visual Basic.Verifique todas as entradas antes de usar os dados no seu aplicativo.
Tarefas
A tabela a seguir lista exemplos de tarefas envolvendo o método My.Computer.FileSystem.ReadAllText.
Para |
Consulte |
|---|---|
Ler de um arquivo de texto |
Exemplo
O exemplo lê o conteúdo de Test.txt em uma cadeia de caracteres e depois o exibe em uma caixa de mensagem.
Dim reader As String
reader = My.Computer.FileSystem.ReadAllText("C:\test.txt")
MsgBox(reader)
O exemplo a seguir, lê o conteúdo de um arquivo ASCII Test.txt em uma cadeia de caracteres e depois o exibe em uma caixa de mensagem.
Dim reader As String
reader = My.Computer.FileSystem.ReadAllText("C:\test.txt", _
System.Text.Encoding.ASCII)
MsgBox(reader)
Requisitos
Namespace:Microsoft.VisualBasic.MyServices
Classe:FileSystemProxy (fornece acesso a FileSystem)
Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)
Disponibilidade por Tipo de Projeto
Tipo de Projeto |
Disponível |
|---|---|
Aplicativo do Windows |
Sim |
Biblioteca de Classe |
Sim |
Aplicativo de Console |
Sim |
Biblioteca de Controle do Windows |
Sim |
Biblioteca de Controle da Web |
Sim |
Serviço do Windows |
Sim |
Site |
Sim |
Permissões
A permissão a seguir pode ser necessária:
Permissão |
Descrição |
|---|---|
Controla a habilidade de acesso a arquivos e pastas.Enumeração associada: Unrestricted. |
Para obter mais informações, consulte Segurança de Acesso de código e Solicitando permissões.
Consulte também
Tarefas
Como: Ler texto de arquivos com um StreamReader (Visual Basic)
Solução de problemas: Leitura e gravação a arquivos de texto
Demonstra Passo a passo: Manipular arquivos e pastas no Visual Basic