My.Computer.FileSystem.OpenTextFileWriter-Methode

Artikel
08/20/2008

Aktualisiert: November 2007

' 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

Parameter

file
String. Datei, in die geschrieben werden soll. Erforderlich.
append
Boolean. Gibt an, ob weitere Informationen an Informationen in der Datei angefügt oder ob die vorhandenen Informationen überschrieben werden sollen. Erforderlich.
encoding
Encoding. Die beim Schreiben in die Datei zu verwendende Codierung. Der Standardwert ist UTF8.

Rückgabewert

StreamWriter

Ausnahmen

Die folgende Bedingung verursacht möglicherweise das Auslösen einer Ausnahme:

Der Dateiname endet mit einem nachgestellten Schrägstrich (ArgumentException).

Hinweise

Die OpenTextFileWriter-Methode öffnet und initialisiert einen Stream für eine Datei und gibt dann das StreamWriter-Objekt für diesen Stream zurück. Sie können so oft wie nötig in den Stream schreiben und ihn anschließend schließen.

Hinweis:
Sie müssen die Close-Methode des StreamWriter-Objekts aufrufen, um sicherzustellen, dass alle Daten ordnungsgemäß in den zugrunde liegenden Stream geschrieben werden.

Wenn der append-Parameter den Wert True hat, wird der Text durch die Methode an die Datei angefügt. Andernfalls wird der in der Datei vorhandene Text überschrieben.

Wenn Sie nur einige wenige Zeichenfolgen in eine Datei schreiben, ist es vielleicht einfacher, die WriteAllText-Methode zu verwenden. Weitere Informationen finden Sie unter My.Computer.FileSystem.WriteAllText-Methode.

Aufgaben

Die folgende Tabelle enthält ein Beispiel für eine Aufgabe mit der My.Computer.FileSystem.OpenTextFileWriter-Methode.

Zweck	Weitere Informationen finden Sie unter
Schreiben von Text in eine Datei unter Verwendung von StreamWriter	Gewusst wie: Schreiben von Text in Dateien mit einem Streamwriter in Visual Basic

Beispiel

In diesem Beispiel wird ein StreamWriter mit der My.Computer.FileSystem.OpenTextFileWriter-Methode geöffnet und dazu verwendet, mithilfe der WriteLine-Methode der StreamWriter-Klasse eine Zeichenfolge in eine Textdatei zu schreiben.

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