Método My.Computer.FileSystem.WriteAllBytes

Grava dados em um arquivo binário.

' Usage
My.Computer.FileSystem.WriteAllBytes(file ,data ,append)
' Declaration
Public Sub WriteAllBytes( _
   ByVal file As String, _
   ByVal data As Byte(), _
   ByVal append As Boolean _
)

Parâmetros

• file
  String.Caminho e o nome do arquivo a ser gravado.Obrigatório.

• data
  Byte.Dados a serem gravados no arquivo.Obrigatório.

• append
  Boolean.Se acrescentar ou substituir os dados.O padrão é False.Obrigatório.

Exceções

As seguintes condições podem criar 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 caminho inválido porque ele é Nothing termina com uma barra invertida (\\\) (ouArgumentNullException).

• The file parâmetro aponta para um caminho não existe)FileNotFoundException ou DirectoryNotFoundException).

• O arquivo está em uso por outro processo, ou ocorre um erro 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).

• O usuário não possui permissões necessárias para exibir o caminho (SecurityException).

Comentários

Se o append o parâmetro é True, ele acrescentará os dados para o arquivo; caso contrário, os dados no arquivo são sobrescritos.

Se inválido for válido, o caminho especificado, nome de arquivo, exceto um DirectoryNotFoundException exceção será lançada. Se o caminho é válido, mas o arquivo não existir, o arquivo é criado.

Observação:
O WriteAllBytes método abre um arquivo, grava-lo e fechá-lo. 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 pode fornecer um desempenho melhor porque você só precisa em em aberto e fechar o arquivo de uma vez.

Tarefas

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

Para	Consulte
Grava em um arquivo binário.	Como: Gravar em arquivos binários no Visual Basic

Exemplo

Este exemplo acrescenta a matriz de dados CustomerData o arquivo CollectedData.

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

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 seguinte permissão pode ser necessária.

Permissão	Descrição
FileIOPermission	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: Gravar em arquivos binários no Visual Basic

Referência

Objeto My.Computer.FileSystem

WriteAllBytes

Outros recursos

Gravando em Arquivos no Visual Basic