FileSystem.WriteAllText Metodo

Definizione

Spazio dei nomi:

Microsoft.VisualBasic.FileIO

Assembly:

Microsoft.VisualBasic.Core.dll

Scrive testo in un file.

Overload

WriteAllText(String, String, Boolean)	Scrive testo in un file.
WriteAllText(String, String, Boolean, Encoding)	Scrive testo in un file.

WriteAllText(String, String, Boolean)

Source:

FileSystem.vb

Scrive testo in un file.

public:
 static void WriteAllText(System::String ^ file, System::String ^ text, bool append);

public static void WriteAllText (string file, string text, bool append);

static member WriteAllText : string * string * bool -> unit

Public Shared Sub WriteAllText (file As String, text As String, append As Boolean)

Parametri

file

String

File in cui scrivere.

text

String

Testo da scrivere nel file.

append

Boolean

True per aggiungere i dati al contenuto del file; False per sovrascrivere il contenuto del file.

Eccezioni

ArgumentException

Il percorso non è valido per uno dei motivi seguenti: si tratta di una stringa di lunghezza zero; contiene solo spazi vuoti; contiene caratteri non validi; o è un percorso del dispositivo (inizia con \\.\); termina con una barra finale.

ArgumentNullException

file è Nothing.

FileNotFoundException

Il file specificato non esiste.

IOException

Il file è in uso in un altro processo oppure si verifica un errore di I/O.

PathTooLongException

La lunghezza del percorso supera la lunghezza massima definita dal sistema.

NotSupportedException

Nel nome di un file o di una directory del percorso sono presenti i due punti (:) oppure il relativo formato non è valido.

OutOfMemoryException

La memoria disponibile non è sufficiente per la scrittura della stringa nel buffer.

SecurityException

L'utente non dispone delle autorizzazioni necessarie per visualizzare il percorso.

Esempio

Questo esempio scrive la riga "This is new text to be added." nel file Test.txt, sovrascrivendo qualsiasi testo esistente nel file.

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

In questo esempio vengono scritti i nomi dei file nella Documents and Settings cartella in FileList.txt, inserendo un ritorno a capo tra ognuno per migliorare la leggibilità.

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

Commenti

La codifica UTF-8 viene usata per scrivere nel file. Per specificare una codifica diversa, usare un overload diverso del WriteAllText metodo .

Se il file specificato non esiste, viene creato.

Se la codifica specificata non corrisponde alla codifica esistente del file, la codifica specificata viene ignorata.

Nota

Il WriteAllText metodo apre un file, lo scrive e lo chiude. Il codice che usa il WriteAllText metodo è più semplice del codice che usa un StreamWriter oggetto . Tuttavia, se si aggiungono stringhe a un file usando un ciclo, un StreamWriter oggetto può offrire prestazioni migliori perché è necessario aprire e chiudere il file una sola volta. Per altre informazioni, vedere il metodo OpenTextFileWriter.

Nella tabella seguente sono elencati esempi di attività che coinvolgono il My.Computer.FileSystem.WriteAllText metodo .

A	Vedere
Scrivere testo in un file	Procedura: scrivere testo in file in Visual Basic
Aggiungere testo a un file	Procedura: aggiungere testo a file di testo in Visual Basic

Vedi anche

• Encoding
• WriteAllText

WriteAllText(String, String, Boolean, Encoding)

Source:

FileSystem.vb

Scrive testo in un file.

public:
 static void WriteAllText(System::String ^ file, System::String ^ text, bool append, System::Text::Encoding ^ encoding);

public static void WriteAllText (string file, string text, bool append, System.Text.Encoding encoding);

static member WriteAllText : string * string * bool * System.Text.Encoding -> unit

Public Shared Sub WriteAllText (file As String, text As String, append As Boolean, encoding As Encoding)

Parametri

file

String

File in cui scrivere.

text

String

Testo da scrivere nel file.

append

Boolean

True per aggiungere i dati al contenuto del file; False per sovrascrivere il contenuto del file.

encoding

Encoding

Codifica da utilizzare per la scrittura nel file.

Eccezioni

ArgumentException

Il percorso non è valido per uno dei motivi seguenti: si tratta di una stringa di lunghezza zero; contiene solo spazi vuoti; contiene caratteri non validi; o è un percorso del dispositivo (inizia con \\.\); termina con una barra finale.

ArgumentNullException

file è Nothing.

FileNotFoundException

Il file specificato non esiste.

IOException

Il file è in uso in un altro processo oppure si verifica un errore di I/O.

PathTooLongException

La lunghezza del percorso supera la lunghezza massima definita dal sistema.

NotSupportedException

Nel nome di un file o di una directory del percorso sono presenti i due punti (:) oppure il relativo formato non è valido.

OutOfMemoryException

La memoria disponibile non è sufficiente per la scrittura della stringa nel buffer.

SecurityException

L'utente non dispone delle autorizzazioni necessarie per visualizzare il percorso.

Esempio

Questo esempio scrive la riga "This is new text to be added." nel file Test.txt, sovrascrivendo qualsiasi testo esistente nel file.

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

In questo esempio vengono scritti i nomi dei file nella Documents and Settings cartella in FileList.txt, inserendo un ritorno a capo tra ognuno per migliorare la leggibilità.

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

Commenti

Se il file specificato non esiste, viene creato.

Se la codifica specificata non corrisponde alla codifica esistente del file, la codifica specificata viene ignorata.

Nota

Il WriteAllText metodo apre un file, lo scrive e lo chiude. Il codice che usa il WriteAllText metodo è più semplice del codice che usa un StreamWriter oggetto . Tuttavia, se si aggiungono stringhe a un file usando un ciclo, un StreamWriter oggetto può offrire prestazioni migliori perché è necessario aprire e chiudere il file una sola volta. Per altre informazioni, vedere il metodo OpenTextFileWriter.

Nella tabella seguente sono elencati esempi di attività che coinvolgono il My.Computer.FileSystem.WriteAllText metodo .

A	Vedere
Scrivere testo in un file	Procedura: scrivere testo in file in Visual Basic
Aggiungere testo a un file	Procedura: aggiungere testo a file di testo in Visual Basic

Vedi anche

• Encoding