FileSystemProxy.WriteAllText 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
將文字寫入檔案。
多載
| WriteAllText(String, String, Boolean) |
將文字寫入檔案。 |
| WriteAllText(String, String, Boolean, Encoding) |
將文字寫入檔案。 |
WriteAllText(String, String, Boolean)
將文字寫入檔案。
public:
void WriteAllText(System::String ^ file, System::String ^ text, bool append);public void WriteAllText (string file, string text, bool append);member this.WriteAllText : string * string * bool -> unitPublic Sub WriteAllText (file As String, text As String, append As Boolean)參數
- file
- String
要寫入的檔案。
- text
- String
要寫入檔案的文字。
- append
- Boolean
True 表示要將內容附加到檔案，False 表示要覆寫檔案的內容。 預設為 False。
例外狀況
路徑無效，原因如下：它是長度為零的字串;它只包含空格符;它包含無效的字元;或它是裝置路徑， (開頭為 \\.\) ;結尾為斜線。
file 為 Nothing。
檔案不存在。
檔案正由另一個程序使用中，或發生 I/O 錯誤。
路徑超過系統定義的最大長度。
路徑中的檔案或目錄名稱含有冒號 (:)，或者是無效的格式。
沒有足夠的記憶體可將字串寫入緩衝區。
使用者缺乏必要的使用權限來檢視路徑。
範例
本範例會將行 "This is new text to be added." 寫入檔案 Test.txt，並覆寫檔案中的任何現有文字。
My.Computer.FileSystem.WriteAllText("C:\TestFolder1\test.txt",
"This is new text to be added.", False)
本範例會將資料夾中的檔名 Documents and Settings 寫入至 FileList.txt，以在每一個之間插入歸位字元，以提升可讀性。
For Each foundFile In
My.Computer.FileSystem.GetFiles("C:\Documents and Settings")
foundFile = foundFile & vbCrLf
My.Computer.FileSystem.WriteAllText(
"C:\Documents and Settings\FileList.txt", foundFile, True)
Next
備註
UTF-8 編碼是用來寫入檔案。 若要指定不同的編碼方式，請使用 方法的不同多 WriteAllText 載。
如果指定的檔案不存在，則會建立該檔案。
如果指定的編碼不符合檔案的現有編碼方式，則會忽略指定的編碼。
注意
方法會 WriteAllText 開啟檔案、寫入檔案，然後關閉檔案。 使用 WriteAllText 方法的程式代碼比使用 StreamWriter 物件的程式代碼更簡單。 不過，如果您要使用 迴圈將字串新增至檔案，物件可以提供更佳的效能， StreamWriter 因為您只需要開啟並關閉檔案一次。 如需詳細資訊，請參閱 OpenTextFileWriter 方法。
下表列出涉及 方法的工作 My.Computer.FileSystem.WriteAllText 範例。
| 收件者 | 請參閱 |
|---|---|
| 將文字寫入檔案 | 作法：將文字寫入檔案 |
| 將文字附加至檔案 | 作法：附加至文字檔 |
另請參閱
適用於
WriteAllText(String, String, Boolean, Encoding)
將文字寫入檔案。
public:
void WriteAllText(System::String ^ file, System::String ^ text, bool append, System::Text::Encoding ^ encoding);public void WriteAllText (string file, string text, bool append, System.Text.Encoding encoding);member this.WriteAllText : string * string * bool * System.Text.Encoding -> unitPublic Sub WriteAllText (file As String, text As String, append As Boolean, encoding As Encoding)參數
- file
- String
要寫入的檔案。
- text
- String
要寫入檔案的文字。
- append
- Boolean
True 表示要將內容附加到檔案，False 表示要覆寫檔案的內容。 預設為 False。
- encoding
- Encoding
寫入檔案時要使用的編碼方式。 預設值為 UTF-8。
例外狀況
路徑無效，原因如下：它是長度為零的字串;它只包含空格符;它包含無效的字元;或它是裝置路徑， (開頭為 \\.\) ;結尾為斜線。
file 為 Nothing。
檔案不存在。
檔案正由另一個程序使用中，或發生 I/O 錯誤。
路徑超過系統定義的最大長度。
路徑中的檔案或目錄名稱含有冒號 (:)，或者是無效的格式。
沒有足夠的記憶體可將字串寫入緩衝區。
使用者缺乏必要的使用權限來檢視路徑。
範例
本範例會將行 "This is new text to be added." 寫入檔案 Test.txt，並覆寫檔案中的任何現有文字。
My.Computer.FileSystem.WriteAllText("C:\TestFolder1\test.txt",
"This is new text to be added.", False)
本範例會將資料夾中的檔名 Documents and Settings 寫入至 FileList.txt，以在每一個之間插入歸位字元，以提升可讀性。
For Each foundFile In
My.Computer.FileSystem.GetFiles("C:\Documents and Settings")
foundFile = foundFile & vbCrLf
My.Computer.FileSystem.WriteAllText(
"C:\Documents and Settings\FileList.txt", foundFile, True)
Next
備註
如果指定的檔案不存在，則會建立該檔案。
如果指定的編碼不符合檔案的現有編碼方式，則會忽略指定的編碼。
注意
方法會 WriteAllText 開啟檔案、寫入檔案，然後關閉檔案。 使用 WriteAllText 方法的程式代碼比使用 StreamWriter 物件的程式代碼更簡單。 不過，如果您要使用 迴圈將字串新增至檔案，物件可以提供更佳的效能， StreamWriter 因為您只需要開啟並關閉檔案一次。 如需詳細資訊，請參閱 OpenTextFileWriter 方法。
下表列出涉及 方法的工作 My.Computer.FileSystem.WriteAllText 範例。
| 收件者 | 請參閱 |
|---|---|
| 將文字寫入檔案 | 作法：將文字寫入檔案 |
| 將文字附加至檔案 | 作法：附加至文字檔 |
