File.WriteAllBytes(String, Byte[]) Método

  • Referência

Definição

Namespace:
System.IO
Assemblies:
mscorlib.dll, System.IO.FileSystem.dll
Assembly:
System.IO.FileSystem.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
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 para gravação.

bytes
Byte[]

Os bytes a serem gravados no arquivo.

Exceções

ArgumentException

.NET Framework e versões 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. Consulte caracteres inválidos usando o método GetInvalidPathChars().

ArgumentNullException

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

PathTooLongException

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

DirectoryNotFoundException

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

IOException

Um erro de E/S ocorreu ao abrir o arquivo.

UnauthorizedAccessException

path especificou um arquivo somente leitura.

- ou -

path especificou um arquivo que está oculto.

- ou -

Não há suporte para essa operação na plataforma atual.

- ou -

path especificou 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.

Aplica-se a