File.WriteAllBytes 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.
Sobrecargas
| WriteAllBytes(String, Byte[]) |
Cria um novo arquivo, grava a matriz de bytes especificada no arquivo e fecha o arquivo. Se o arquivo de destino já existir, ele será truncado e substituído. |
| WriteAllBytes(String, ReadOnlySpan<Byte>) |
Cria um novo arquivo, grava a matriz de bytes especificada no arquivo e fecha o arquivo. Se o arquivo de destino já existir, ele será truncado e substituído. |
WriteAllBytes(String, Byte[])
- Origem:
- File.cs
- Origem:
- File.cs
- Origem:
- File.cs
Cria um novo arquivo, grava a matriz de bytes especificada no arquivo e fecha o arquivo. Se o arquivo de destino já existir, ele será truncado e substituído.
public:
static void WriteAllBytes(System::String ^ path, cli::array <System::Byte> ^ bytes);public static void WriteAllBytes (string path, byte[] bytes);static member WriteAllBytes : string * byte[] -> unitPublic Shared Sub WriteAllBytes (path As String, bytes As Byte())Parâmetros
- path
- String
O arquivo no qual gravar.
- bytes
- Byte[]
Os bytes a serem gravados no arquivo.
Exceções
Versões do .NET Framework e do .NET Core anteriores à 2.1: path é uma cadeia de caracteres de comprimento zero, contém apenas espaço em branco ou contém um ou mais caracteres inválidos. Você pode consultar caracteres inválidos usando o método GetInvalidPathChars().
path é null ou a matriz de bytes está vazia.
O caminho especificado, o nome do arquivo ou ambos excedem o comprimento máximo definido pelo sistema.
O caminho especificado é inválido (por exemplo, ele está em uma unidade não mapeada).
Ocorreu um erro de E/S ao abrir o arquivo.
path especificado um arquivo que é somente leitura.
-ou-
path especificado um arquivo oculto.
-ou-
Não há suporte para essa operação na plataforma atual.
-ou-
path especificado um diretório.
-ou-
O chamador não tem a permissão necessária.
path está em um formato inválido.
O chamador não tem a permissão necessária.
Comentários
Considerando uma matriz de bytes e um caminho de arquivo, esse método abre o arquivo especificado, grava o conteúdo da matriz de bytes no arquivo e fecha o arquivo.
Aplica-se a
WriteAllBytes(String, ReadOnlySpan<Byte>)
Cria um novo arquivo, grava a matriz de bytes especificada no arquivo e fecha o arquivo. Se o arquivo de destino já existir, ele será truncado e substituído.
public:
static void WriteAllBytes(System::String ^ path, ReadOnlySpan<System::Byte> bytes);public static void WriteAllBytes (string path, ReadOnlySpan<byte> bytes);static member WriteAllBytes : string * ReadOnlySpan<byte> -> unitPublic Shared Sub WriteAllBytes (path As String, bytes As ReadOnlySpan(Of Byte))Parâmetros
- path
- String
O arquivo no qual gravar.
- bytes
- ReadOnlySpan<Byte>
Os bytes a serem gravados no arquivo.
Exceções
path é null.
path está vazio.
O caminho especificado, o nome do arquivo ou ambos excedem o comprimento máximo definido pelo sistema.
O caminho especificado é inválido (por exemplo, ele está em uma unidade não mapeada).
Ocorreu um erro de E/S ao abrir o arquivo.
path especificado um arquivo que é somente leitura.
-ou-
path especificado um arquivo oculto.
-ou-
path especificado um diretório.
-ou-
O chamador não tem a permissão necessária.
-ou-
Não há suporte para essa operação na plataforma atual.
path está em um formato inválido.
