Metodo My.Computer.FileSystem.WriteAllText

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.

Attività

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

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

Autorizzazioni

Potrebbero essere necessarie le seguenti autorizzazioni:

Per ulteriori informazioni, vedere Protezione dall'accesso di codice e Richiesta di autorizzazioni.

Vedere anche

Riferimenti

Oggetto My.Computer.FileSystem

System.Text.Encoding

FileSystem.WriteAllText

Metodo My.Computer.FileSystem.OpenTextFileWriter

Altre risorse

Scrittura su file in Visual Basic