FileSystemProxy.WriteAllText 方法

定義

命名空間:

Microsoft.VisualBasic.MyServices

組件:

Microsoft.VisualBasic.Forms.dll

將文字寫入檔案。

多載

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 -> unit

Public Sub WriteAllText (file As String, text As String, append As Boolean)

參數

file

String

要寫入的檔案。

text

String

要寫入檔案的文字。

append

Boolean

True 表示要將內容附加到檔案，False 表示要覆寫檔案的內容。 預設為 False。

例外狀況

ArgumentException

路徑無效，原因如下：它是長度為零的字串;它只包含空格符;它包含無效的字元;或它是裝置路徑， (開頭為 \\.\) ;結尾為斜線。

ArgumentNullException

file 為 Nothing。

FileNotFoundException

檔案不存在。

IOException

檔案正由另一個程序使用中，或發生 I/O 錯誤。

PathTooLongException

路徑超過系統定義的最大長度。

NotSupportedException

路徑中的檔案或目錄名稱含有冒號 (:)，或者是無效的格式。

OutOfMemoryException

沒有足夠的記憶體可將字串寫入緩衝區。

SecurityException

使用者缺乏必要的使用權限來檢視路徑。

範例

本範例會將行 "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 範例。

收件者	請參閱
將文字寫入檔案	作法：將文字寫入檔案
將文字附加至檔案	作法：附加至文字檔

另請參閱

• Encoding
• WriteAllText(String, String, Boolean)
• 物件 (Visual Basic)
• 在 Visual Basic 中寫入檔案

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 -> unit

Public 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。

例外狀況

ArgumentException

路徑無效，原因如下：它是長度為零的字串;它只包含空格符;它包含無效的字元;或它是裝置路徑， (開頭為 \\.\) ;結尾為斜線。

ArgumentNullException

file 為 Nothing。

FileNotFoundException

檔案不存在。

IOException

檔案正由另一個程序使用中，或發生 I/O 錯誤。

PathTooLongException

路徑超過系統定義的最大長度。

NotSupportedException

路徑中的檔案或目錄名稱含有冒號 (:)，或者是無效的格式。

OutOfMemoryException

沒有足夠的記憶體可將字串寫入緩衝區。

SecurityException

使用者缺乏必要的使用權限來檢視路徑。

範例

本範例會將行 "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 範例。

收件者	請參閱
將文字寫入檔案	作法：將文字寫入檔案
將文字附加至檔案	作法：附加至文字檔

另請參閱

• Encoding
• 物件 (Visual Basic)
• 在 Visual Basic 中寫入檔案