FileSystem.WriteAllText Metodo

Definizione

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
Source:
FileSystem.vb
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

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.

file è Nothing.

Il file specificato non esiste.

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

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

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

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

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

Si applica a

WriteAllText(String, String, Boolean, Encoding)

Source:
FileSystem.vb
Source:
FileSystem.vb
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

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.

file è Nothing.

Il file specificato non esiste.

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

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

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

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

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

Si applica a