Compartilhar via


File.WriteAllBytes Método

Definição

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[] -> unit
Public 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> -> unit
Public 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.

Aplica-se a