My.Computer.FileSystem.OpenTextFileWriter 方法

项目
08/18/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 将文本写入到文件中	如何：在 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()