FileSystemProxy.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:
void WriteAllBytes(System::String ^ file, cli::array <System::Byte> ^ data, bool append);public void WriteAllBytes(string file, byte[] data, bool append);member this.WriteAllBytes : string * byte[] * bool -> unitPublic Sub WriteAllBytes (file As String, data As Byte(), append As Boolean)Parâmetros
- file
- String
Caminho e nome do arquivo a ser gravado.
- data
- Byte[]
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 caracteres de comprimento zero; ele contém apenas espaço em branco; ele contém caracteres inválidos; ou é um caminho do dispositivo (começa com \\.\); termina com uma barra à direita.
file é Nothing.
O arquivo não existe.
O arquivo está em uso por outro processo ou ocorre um erro de E/S.
O caminho excede o comprimento máximo definido pelo sistema.
Um nome de arquivo ou 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 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 que envolve o My.Computer.FileSystem.WriteAllBytes método.
| Para | Veja |
|---|---|
| Gravar em um arquivo binário | Como gravar em arquivos binários |