File.WriteAllBytes 方法

定義

命名空間:

System.IO

組件:

System.Runtime.dll

多載

WriteAllBytes(String, 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

比 2.1 舊的 .NET Framework 和 .NET Core 版本：path 是長度為零的字串、只包含空格符，或包含一或多個無效字元。 您可以使用 GetInvalidPathChars() 方法來查詢無效的字元。

ArgumentNullException

path 是 null，或位元組陣列是空的。

PathTooLongException

指定的路徑、檔名或兩者都超過系統定義的最大長度。

DirectoryNotFoundException

指定的路徑無效（例如，它位於未對應的磁碟驅動器上）。

IOException

開啟檔案時發生 I/O 錯誤。

UnauthorizedAccessException

path 指定唯讀的檔案。

-或-

path 指定隱藏的檔案。

-或-

目前平臺不支援此作業。

-或-

path 指定目錄。

-或-

呼叫端沒有必要的許可權。

NotSupportedException

path 格式無效。

SecurityException

呼叫端沒有必要的許可權。

備註

指定位元組陣列和檔案路徑時，這個方法會開啟指定的檔案、將位元組數位的內容寫入檔案，然後關閉檔案。