Прочитать на английском

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


File.WriteAllBytes Метод

Определение

Перегрузки

WriteAllBytes(String, Byte[])

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

WriteAllBytes(String, ReadOnlySpan<Byte>)

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

WriteAllBytes(String, Byte[])

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

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

C#
public static void WriteAllBytes(string path, byte[] bytes);

Параметры

path
String

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

bytes
Byte[]

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

Исключения

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

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

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

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

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

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

-или-

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

-или-

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

-или-

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

-или-

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

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

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

Комментарии

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

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

.NET 10 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

WriteAllBytes(String, ReadOnlySpan<Byte>)

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

C#
public static void WriteAllBytes(string path, ReadOnlySpan<byte> bytes);

Параметры

path
String

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

bytes
ReadOnlySpan<Byte>

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

Исключения

path пуст.

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

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

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

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

-или-

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

-или-

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

-или-

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

-или-

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

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

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

.NET 10 и .NET 9
Продукт Версии
.NET 9, 10