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

Definição

Espaço de Nomes:
Microsoft.VisualBasic.FileIO
Assemblagem:
Microsoft.VisualBasic.dll

Escreve dados num ficheiro 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

Caminho e nome do ficheiro a ser escrito.

data
Byte[]

Dados a serem escritos no ficheiro.

append
Boolean

True para acrescentar ao conteúdo do ficheiro; False para sobrescrever o conteúdo do ficheiro. A predefinição é False.

Exceções

ArgumentException

O caminho não é válido por uma das seguintes razões: é uma cadeia de comprimento zero; contém apenas espaço em branco; contém caracteres inválidos; ou é um caminho de dispositivo (começa por \\.\); termina com um corte de arrasto.

ArgumentNullException

file é Nothing.

FileNotFoundException

O ficheiro não existe.

IOException

O ficheiro é utilizado por outro processo, ou ocorre um erro de E/S.

PathTooLongException

O percurso excede o comprimento máximo definido pelo sistema.

NotSupportedException

Um nome de ficheiro ou diretório no caminho contém dois pontos (:) ou está num formato inválido.

OutOfMemoryException

Não há memória suficiente para escrever a string para buffer.

SecurityException

O utilizador não tem as permissões necessárias para visualizar o caminho.

Exemplos

Este exemplo acrescenta o array CustomerData de dados ao ficheiro CollectedData.

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

Observações

Se o caminho especificado, excluindo o nome do ficheiro, não for válido, será lançada uma DirectoryNotFoundException exceção. Se o caminho for válido mas o ficheiro não existir, o ficheiro é criado.

Note

O WriteAllBytes método abre um ficheiro, escreve nele e depois fecha-o. O código que usa o WriteAllBytes método é mais simples do que o código que usa um BinaryWriter objeto. No entanto, se estiveres a adicionar dados a um ficheiro usando um loop, um BinaryWriter objeto pode proporcionar melhor desempenho porque só tens de abrir e fechar o ficheiro uma vez.

A tabela seguinte apresenta um exemplo de uma tarefa envolvendo o My.Computer.FileSystem.WriteAllBytes método.

Para Veja
Gravar em um arquivo binário Como: Escrever em ficheiros binários em Visual Basic

Aplica-se a