Поделиться через


File.WriteAllBytes Метод

Определение

Перегрузки

WriteAllBytes(String, Byte[])

Создает новый файл, записывает указанный массив байтов в файл, а затем закрывает файл. Если целевой файл уже существует, он усечен и перезаписан.

WriteAllBytes(String, ReadOnlySpan<Byte>)

Создает новый файл, записывает указанный массив байтов в файл, а затем закрывает файл. Если целевой файл уже существует, он усечен и перезаписан.

WriteAllBytes(String, Byte[])

Исходный код:
File.cs
Исходный код:
File.cs
Исходный код:
File.cs

Создает новый файл, записывает указанный массив байтов в файл, а затем закрывает файл. Если целевой файл уже существует, он усечен и перезаписан.

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

Параметры

path
String

Файл для записи.

bytes
Byte[]

Байты для записи в файл.

Исключения

Версии .NET Framework и .NET Core старше 2.1: path представляет собой строку нулевой длины, содержит только пробелы или содержит один или несколько недопустимых символов. Вы можете запросить недопустимые символы с помощью метода GetInvalidPathChars().

path null или массив байтов пуст.

Указанный путь, имя файла или оба превышают определенную системой максимальную длину.

Указанный путь недопустим (например, он находится на несопоставленном диске).

При открытии файла произошла ошибка ввода-вывода.

path указали файл, доступный только для чтения.

-или-

path указать скрытый файл.

-или-

Эта операция не поддерживается на текущей платформе.

-или-

path указан каталог.

-или-

Вызывающий объект не имеет требуемого разрешения.

path имеет недопустимый формат.

Вызывающий объект не имеет требуемого разрешения.

Комментарии

Если массив байтов и путь к файлу, этот метод открывает указанный файл, записывает содержимое массива байтов в файл, а затем закрывает файл.

Применяется к

WriteAllBytes(String, ReadOnlySpan<Byte>)

Создает новый файл, записывает указанный массив байтов в файл, а затем закрывает файл. Если целевой файл уже существует, он усечен и перезаписан.

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

Параметры

path
String

Файл для записи.

bytes
ReadOnlySpan<Byte>

Байты для записи в файл.

Исключения

path пуст.

Указанный путь, имя файла или оба превышают определенную системой максимальную длину.

Указанный путь недопустим (например, он находится на несопоставленном диске).

При открытии файла произошла ошибка ввода-вывода.

path указали файл, доступный только для чтения.

-или-

path указать скрытый файл.

-или-

path указан каталог.

-или-

Вызывающий объект не имеет требуемого разрешения.

-или-

Эта операция не поддерживается на текущей платформе.

path имеет недопустимый формат.

Применяется к