Metodo My.Computer.FileSystem.OpenTextFileWriter

Articolo
09/12/2008

Aggiornamento: novembre 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

Parametri

file
String. File nel quale scrivere. Obbligatorio
append
Boolean. Consente di specificare se aggiungere o sovrascrivere le informazioni nel file. Obbligatorio.
encoding
Encoding. Codifica da utilizzare durante la scrittura nel file. Il valore predefinito è UTF8.

Valore restituito

StreamWriter

Eccezioni

La seguente condizione può causare la generazione di un'eccezione:

Il nome di file termina con una barra finale (ArgumentException).

Note

Viene aperto il metodo OpenTextFileWriter che inizializza un flusso per un file e quindi restituisce l'oggetto StreamWriter per quel flusso. È possibile scrivere nel flusso tutte le volte necessarie e quindi, al termine, chiuderlo.

Nota:
È necessario chiamare il metodo Close sull'oggetto StreamWriter per fare in modo che tutti i dati vengano scritti correttamente nel flusso sottostante.

Se il parametro append è impostato su True, il metodo aggiunge il testo al file. In caso contrario, il testo esistente nel file viene sovrascritto.

Per scrivere solo alcune stringhe in un file, potrebbe essere più semplice utilizzare il metodo WriteAllText. Per ulteriori informazioni, vedere Metodo My.Computer.FileSystem.WriteAllText.

Attività

Nella tabella riportata di seguito viene elencato un esempio di un'attività che utilizza il metodo My.Computer.FileSystem.OpenTextFileWriter.

Per	Vedere
Scrivere testo in un file utilizzando un StreamWriter	Procedura: scrivere testo all'interno di file con uno StreamWriter in Visual Basic

Esempio

In questo esempio, una classe StreamWriter viene aperta con il metodo My.Computer.FileSystem.OpenTextFileWriter e viene utilizzata per scrivere una stringa in un file di testo con il metodo WriteLine della classe StreamWriter.

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

Requisiti

Spazio dei nomi:Microsoft.VisualBasic.MyServices

Classe:FileSystemProxy (fornisce l'accesso a FileSystem)

Assembly: la libreria di runtime di Visual Basic (in Microsoft.VisualBasic.dll)

Disponibilità in base al tipo di progetto

Tipo di progetto	Disponibile
Applicazione Windows	Sì
Libreria di classi	Sì
Applicazione di console	Sì
Libreria di controlli Windows	Sì
Libreria di controllo Web	Sì
Servizio Windows	Sì
Sito Web	Sì