My.Computer.FileSystem.OpenTextFileWriter 方法

發行項
08/21/2008

更新：2007 年 11 月

' Usage
Dim value As System.IO.StreamWriter = My.Computer.FileSystem.OpenTextFileWriter(file ,append)
Dim value As System.IO.StreamWriter = My.Computer.FileSystem.OpenTextFileWriter(file ,append ,encoding)
' Declaration
Public Function OpenTextFileWriter( _
   ByVal file As String, _
   ByVal append As Boolean _
) As System.IO.StreamWriter
' -or-
Public Function OpenTextFileWriter( _
   ByVal file As String, _
   ByVal append As Boolean, _
   ByVal encoding As System.Text.Encoding _
) As System.IO.StreamWriter

參數

file
String。要寫入的檔案。必要項。
append
Boolean。指定要附加或覆寫檔案中的資訊。必要項，
encoding
Encoding。編碼方式會用於寫入檔案。預設值為 UTF8。

傳回值

StreamWriter

例外狀況

下列條件可能造成擲回例外狀況：

檔案名稱以斜線結束 (ArgumentException)。

備註

OpenTextFileWriter 方法會開啟並初始化檔案的資料流，然後傳回該資料流的 StreamWriter 物件。您可以視需要多次寫入資料流，並在完成後將其關閉。

注意事項：
您必須對 StreamWriter 物件呼叫 Close 方法，以確認所有資料都正確地寫入基礎資料流。

如果 append 參數為 True，方法會將文字附加至檔案，否則會覆寫檔案中的現有文字。

如果只要將少數字串寫入檔案，則使用 WriteAllText 方法會比較簡單。如需詳細資訊，請參閱My.Computer.FileSystem.WriteAllText 方法。

工作

下表列出包含 My.Computer.FileSystem.OpenTextFileWriter 方法的工作範例。

若要	請參閱
使用 StreamWriter 將文字寫入檔案	HOW TO：在 Visual Basic 中以 StreamWriter 將文字寫入檔案

範例

這個範例會以 My.Computer.FileSystem.OpenTextFileWriter 方法開啟 StreamWriter，並使用它透過 StreamWriter 類別的 WriteLine 方法，將字串寫入至文字檔。

Dim file As System.IO.StreamWriter
file = My.Computer.FileSystem.OpenTextFileWriter("c:\test.txt", True)
file.WriteLine("Here is the first string.")
file.Close()