FileSystem.WriteAllBytes(String, Byte[], Boolean) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 -> unitPublic 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 |
