File.WriteAllBytes Метод

Определение

Пространство имен:

System.IO

Сборки:

netstandard.dll, System.Runtime.dll

Перегрузки

Имя	Описание
WriteAllBytes(String, Byte[])	Создает новый файл, записывает указанный массив байтов в файл, а затем закрывает файл. Если целевой файл уже существует, он усечен и перезаписан.
WriteAllBytes(String, ReadOnlySpan<Byte>)	Создает новый файл, записывает указанный массив байтов в файл, а затем закрывает файл. Если целевой файл уже существует, он усечен и перезаписан.

WriteAllBytes(String, Byte[])

Исходный код:

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[]

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

Исключения

ArgumentException

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

ArgumentNullException

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

PathTooLongException

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

DirectoryNotFoundException

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

IOException

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

UnauthorizedAccessException

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

-или-

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

-или-

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

-или-

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

-или-

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

NotSupportedException

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

SecurityException

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

Комментарии

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

WriteAllBytes(String, ReadOnlySpan<Byte>)

Исходный код:

File.cs

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

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>

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

Исключения

ArgumentNullException

path null.

ArgumentException

path пуст.

PathTooLongException

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

DirectoryNotFoundException

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

IOException

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

UnauthorizedAccessException

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

-или-

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

-или-

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

-или-

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

-или-

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

NotSupportedException

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