FileSystem.WriteAllText 方法

定義

命名空間:

Microsoft.VisualBasic.FileIO

組件:

Microsoft.VisualBasic.Core.dll

將文字寫入檔案。

多載

WriteAllText(String, String, Boolean)	將文字寫入檔案。
WriteAllText(String, String, Boolean, Encoding)	將文字寫入檔案。

WriteAllText(String, String, Boolean)

來源:

FileSystem.vb

將文字寫入檔案。

public:
 static void WriteAllText(System::String ^ file, System::String ^ text, bool append);

public static void WriteAllText (string file, string text, bool append);

static member WriteAllText : string * string * bool -> unit

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

參數

file

String

要寫入的檔案。

text

String

要寫入檔案的文字。

append

Boolean

True 表示要將內容附加到檔案，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 方法的工作範例。

收件者	請參閱
將文字寫入檔案	如何：在 Visual Basic 中將文字寫入檔案
將文字附加至檔案	如何：在 Visual Basic 中附加至文字檔

另請參閱

• Encoding
• WriteAllText

WriteAllText(String, String, Boolean, Encoding)

來源:

FileSystem.vb

將文字寫入檔案。

public:
 static void WriteAllText(System::String ^ file, System::String ^ text, bool append, System::Text::Encoding ^ encoding);

public static void WriteAllText (string file, string text, bool append, System.Text.Encoding encoding);

static member WriteAllText : string * string * bool * System.Text.Encoding -> unit

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

參數

file

String

要寫入的檔案。

text

String

要寫入檔案的文字。

append

Boolean

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

encoding

Encoding

寫入檔案時要使用的編碼方式。

例外狀況

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 方法的工作範例。

收件者	請參閱
將文字寫入檔案	如何：在 Visual Basic 中將文字寫入檔案
將文字附加至檔案	如何：在 Visual Basic 中附加至文字檔

另請參閱

• Encoding