File.WriteAllBytes 方法
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
| WriteAllBytes(String, Byte[]) |
创建一个新文件，将指定的字节数组写入文件，然后关闭该文件。 如果目标文件已存在，则会截断并覆盖该文件。 |
| WriteAllBytes(String, ReadOnlySpan<Byte>) |
创建一个新文件，将指定的字节数组写入文件，然后关闭该文件。 如果目标文件已存在，则会截断并覆盖该文件。 |
- Source:
- File.cs
- Source:
- File.cs
- Source:
- 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[] -> unitPublic Shared Sub WriteAllBytes (path As String, bytes As Byte())参数
- path
- String
要写入的文件。
- bytes
- Byte[]
要写入文件的字节数。
例外
低于 2.1 的 .NET Framework 和 .NET Core 版本：path 为零长度的字符串，仅包含空格，或包含一个或多个无效字符。 可以使用 GetInvalidPathChars() 方法查询无效字符。
path 为 null 或字节数组为空。
指定的路径、文件名或两者都超过了系统定义的最大长度。
指定的路径无效（例如，它位于未映射的驱动器上）。
打开文件时出现 I/O 错误。
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 |
创建一个新文件，将指定的字节数组写入文件，然后关闭该文件。 如果目标文件已存在，则会截断并覆盖该文件。
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> -> unitPublic Shared Sub WriteAllBytes (path As String, bytes As ReadOnlySpan(Of Byte))参数
- path
- String
要写入的文件。
- bytes
- ReadOnlySpan<Byte>
要写入文件的字节数。
例外
path
null。
path 为空。
指定的路径、文件名或两者都超过了系统定义的最大长度。
指定的路径无效（例如，它位于未映射的驱动器上）。
打开文件时出现 I/O 错误。
path 指定了只读文件。
-或-
path 指定了隐藏的文件。
-或-
path 指定了目录。
-或-
调用方没有所需的权限。
-或-
当前平台上不支持此操作。
path 格式无效。
适用于
.NET 10 和 .NET 9
| 产品 | 版本 |
|---|---|
| .NET | 9, 10 |
