Partilhar via


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

Definição

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

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 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

Aplica-se a