Share via

FileSystem.ReadAllBytes(String) Método

  • Referência

Definição

Namespace:
Microsoft.VisualBasic.FileIO
Assembly:
Microsoft.VisualBasic.Core.dll
Assembly:
Microsoft.VisualBasic.dll
Origem:
FileSystem.vb
Origem:
FileSystem.vb
Origem:
FileSystem.vb

Retorna o conteúdo de um arquivo como uma matriz de bytes.

public:
 static cli::array <System::Byte> ^ ReadAllBytes(System::String ^ file);
public static byte[] ReadAllBytes (string file);
static member ReadAllBytes : string -> byte[]
Public Shared Function ReadAllBytes (file As String) As Byte()

Parâmetros

file
String

O arquivo a ser lido.

Retornos

Byte[]

Uma matriz Byte 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ê do arquivo C:/Documents and Settings/selfportrait.jpg.

My.Computer.FileSystem.ReadAllBytes(
  "C:/Documents and Settings/selfportrait.jpg")

Comentários

O ReadAllBytes método do My.Computer.FileSystem objeto permite que você leia de um arquivo binário. O conteúdo do arquivo é retornado como uma matriz de bytes.

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.ReadAllBytes método .

Para Consulte
Ler de um arquivo binário Como ler a partir de arquivos binários no Visual Basic

Aplica-se a