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[] -> 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
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários