File.WriteAllBytes Método

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

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

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

ArgumentException

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().

ArgumentNullException

path é null ou a matriz de bytes está vazia.

PathTooLongException

O caminho especificado, o nome do arquivo ou ambos excedem o comprimento máximo definido pelo sistema.

DirectoryNotFoundException

O caminho especificado é inválido (por exemplo, ele está em uma unidade não mapeada).

IOException

Ocorreu um erro de E/S ao abrir o arquivo.

UnauthorizedAccessException

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.

NotSupportedException

path está em um formato inválido.

SecurityException

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.

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

ArgumentNullException

path é null.

ArgumentException

path está vazio.

PathTooLongException

O caminho especificado, o nome do arquivo ou ambos excedem o comprimento máximo definido pelo sistema.

DirectoryNotFoundException

O caminho especificado é inválido (por exemplo, ele está em uma unidade não mapeada).

IOException

Ocorreu um erro de E/S ao abrir o arquivo.

UnauthorizedAccessException

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.

NotSupportedException

path está em um formato inválido.