Metodo My.Computer.FileSystem.WriteAllText

Articolo
09/12/2008

Aggiornamento: novembre 2007

Consente di scrivere del testo in un file.

' Usage
My.Computer.FileSystem.WriteAllText(file ,text ,append)
My.Computer.FileSystem.WriteAllText(file ,text ,append ,encoding)
' Declaration
Public Sub WriteAllText( _
   ByVal file As String, _
   ByVal text As String, _
   ByVal append As Boolean _
)
' -or-
Public Sub WriteAllText( _
   ByVal file As String, _
   ByVal text As String, _
   ByVal append As Boolean, _
   ByVal encoding As System.Text.Encoding _
)

Parametri

file
String. File nel quale scrivere. Obbligatorio
text
String. Testo da scrivere nel file. Obbligatorio.
append
Boolean. Consente di specificare se aggiungere il testo o sovrascrivere quello esistente. Il valore predefinito è False. Obbligatorio.
encoding
Encoding. La codifica da utilizzare quando si scrive nel file. Obbligatorio. Il valore predefinito è UTF-8.

Eccezioni

Le seguenti condizioni possono generare un'eccezione:

Il percorso non è valido per uno dei seguenti motivi: è una stringa di lunghezza zero, contiene solo spazi vuoti, contiene caratteri non validi, termina con una barra finale o corrisponde al percorso di un dispositivo, vale a dire inizia con \\\\.\\ (ArgumentException).
Il percorso non è valido in quanto Nothing (ArgumentNullException).
file fa riferimento a un percorso che non esiste (FileNotFoundException o DirectoryNotFoundException).
Il file è utilizzato da un altro processo o si è verificato un errore di I/O (IOException).
La lunghezza del percorso supera la lunghezza massima definita dal sistema (PathTooLongException).
Un nome di file o di directory nel percorso contiene i due punti (:) o ha un formato non valido (NotSupportedException).
L'utente non dispone delle autorizzazioni necessarie per visualizzare il percorso (SecurityException).

Se l'esecuzione avviene in un contesto parzialmente attendibile, è possibile che il codice generi un'eccezione dovuta a autorizzazioni insufficienti. Per ulteriori informazioni, vedere Nozioni fondamentali sulla protezione dall’accesso di codice.

Note

Quando non è stata specificata alcuna codifica, viene utilizzata la codifica predefinita UTF-8. L'indicatore per l'ordine dei byte (BOM, Byte Order Mark) per la codifica viene scritto nel file, a meno che non si specifichi Encoding.Default, che utilizza la tabella dei codici ANSI corrente del sistema. Se la codifica specificata non corrisponde alla codifica esistente del file, viene ignorata.

Se il percorso specificato, escludendo il nome del file, non è valido, viene generata un'eccezione DirectoryNotFoundException. Se il percorso è valido ma il file non esiste, verrà creato.

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

Nota:
Il metodo WriteAllText apre un file, scrive e quindi lo chiude. Il codice che utilizza il metodo WriteAllText è più semplice del codice che utilizza un oggetto StreamWriter. Tuttavia, se si stanno aggiungendo stringhe a un file utilizzando un ciclo, un oggetto StreamWriter può fornire prestazioni migliori perché deve solo aprire e chiudere una volta il file. Per ulteriori informazioni, vedere Metodo My.Computer.FileSystem.OpenTextFileWriter.

Il metodo WriteAllText apre un file, scrive e quindi lo chiude. Il codice che utilizza il metodo WriteAllText è più semplice del codice che utilizza un oggetto StreamWriter. Tuttavia, se si stanno aggiungendo stringhe a un file utilizzando un ciclo, un oggetto StreamWriter può fornire prestazioni migliori perché deve solo aprire e chiudere una volta il file. Per ulteriori informazioni, vedere Metodo My.Computer.FileSystem.OpenTextFileWriter.

Attività

Nella tabella riportata di seguito sono elencati esempi di attività relative al metodo My.Computer.FileSystem.WriteAllText.

Per	Vedere
Scrivere testo in un file	Procedura: scrivere testo all'interno di file in Visual Basic
Aggiungere testo in un file	Procedura: aggiungere testo a file di testo in Visual Basic

Esempio

Nell'esempio seguente viene scritta la riga "This is new text to be added." nel file Test.txt sovrascrivendo il testo esistente.

My.Computer.FileSystem.WriteAllText("C:\TestFolder1\test.txt", _
"This is new text to be added.", False)

Nell'esempio seguente vengono scritti i nomi dei file nella cartella Documents and Settings inclusa in FileList.txt e viene inserito un ritorno a capo tra i nomi per una migliore leggibilità.

For Each foundFile As String 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

Requisiti

Spazio dei nomi:Microsoft.VisualBasic.MyServices

Classe:FileSystemProxy (fornisce accesso a FileSystem)

Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Disponibilità per tipo di progetto

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