FileSystem.WriteAllBytes(String, Byte[], Boolean) Método

Definição

Namespace:

Microsoft.VisualBasic.FileIO

Assembly:

Microsoft.VisualBasic.Core.dll

Origem:

FileSystem.vb

Grava dados em um arquivo binário.

public:
 static void WriteAllBytes(System::String ^ file, cli::array <System::Byte> ^ data, bool append);

public static void WriteAllBytes (string file, byte[] data, bool append);

static member WriteAllBytes : string * byte[] * bool -> unit

Public Shared Sub WriteAllBytes (file As String, data As Byte(), append As Boolean)

Parâmetros

file

String

O caminho e o nome do arquivo no qual gravar.

data

Byte[]

Os dados a serem gravados no arquivo.

append

Boolean

True para acrescentar ao conteúdo do arquivo, False para substituir o conteúdo do arquivo. O padrão é False.

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 acrescenta a matriz CustomerData de dados ao arquivo CollectedData.

My.Computer.FileSystem.WriteAllBytes(
  "C:\MyDocuments\CustomerData", CustomerData, True)

Comentários

Se o caminho especificado, excluindo o nome do arquivo, não for válido, uma DirectoryNotFoundException exceção será gerada. Se o caminho for válido, mas o arquivo não existir, o arquivo será criado.

Observação

O WriteAllBytes método abre um arquivo, grava nele e o fecha. O código que usa o WriteAllBytes método é mais simples do que o código que usa um BinaryWriter objeto . No entanto, se você estiver adicionando dados a um arquivo usando um loop, um BinaryWriter objeto poderá fornecer melhor desempenho porque você só precisa abrir e fechar o arquivo uma vez.

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

Para	Consulte
Gravar em um arquivo binário	Como gravar em arquivos binários no Visual Basic