File.WriteAllBytes(String, Byte[]) 方法

定義

命名空間:

System.IO

組件:

System.Runtime.dll

來源:

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 和 2.1 之前的 .NET Core 版本：path是長度為零的字串、只包含空格符，或包含一或多個無效字元。 您可以使用 GetInvalidPathChars() 方法查詢無效字元。

ArgumentNullException

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

PathTooLongException

指定的路徑、檔案名稱，或兩者都超出系統定義的長度上限。

DirectoryNotFoundException

指定的路徑無效 (例如，它位於未對應的磁碟機上)。

IOException

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

UnauthorizedAccessException

path 指定了唯讀的檔案。

-或-

path 指定了隱藏的檔案。

-或-

這個作業在目前平台不受支援。

-或-

path 指定了目錄。

-或-

呼叫端沒有必要的權限。

NotSupportedException

path 格式無效。

SecurityException

呼叫端沒有必要的權限。

備註

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