FileSystemProxy.WriteAllText Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Scrive testo in un file.
Overload
| Nome | Descrizione |
|---|---|
| WriteAllText(String, String, Boolean) |
Scrive testo in un file. |
| WriteAllText(String, String, Boolean, Encoding) |
Scrive testo in un file. |
WriteAllText(String, String, Boolean)
Scrive testo in un file.
public:
void WriteAllText(System::String ^ file, System::String ^ text, bool append);public void WriteAllText(string file, string text, bool append);member this.WriteAllText : string * string * bool -> unitPublic 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 accodare al contenuto del file; False per sovrascrivere il contenuto del file. Il valore predefinito è False.
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 non esiste.
Il file è in uso da un altro processo o si verifica un errore di I/O.
Il percorso supera la lunghezza massima definita dal sistema.
Un nome di file o directory nel percorso contiene due punti (:) o è in un formato non valido.
Memoria insufficiente per scrivere la 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 FileList.txtin , 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.
Note
Il WriteAllText metodo apre un file, lo scrive e quindi 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 .
| Per | Vedi |
|---|---|
| Scrivere testo in un file | Procedura: Scrivere testo in file |
| Aggiungere testo a un file | Procedura: Aggiungere a file di testo |
Vedi anche
- Encoding
- WriteAllText(String, String, Boolean)
- Oggetti (Visual Basic)
- Crittura in file in Visual Basic
Si applica a
WriteAllText(String, String, Boolean, Encoding)
Scrive testo in un file.
public:
void WriteAllText(System::String ^ file, System::String ^ text, bool append, System::Text::Encoding ^ encoding);public void WriteAllText(string file, string text, bool append, System.Text.Encoding encoding);member this.WriteAllText : string * string * bool * System.Text.Encoding -> unitPublic 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 accodare al contenuto del file; False per sovrascrivere il contenuto del file. Il valore predefinito è False.
- encoding
- Encoding
Codifica da usare per la scrittura nel file. Il valore predefinito è UTF-8.
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 non esiste.
Il file è in uso da un altro processo o si verifica un errore di I/O.
Il percorso supera la lunghezza massima definita dal sistema.
Un nome di file o directory nel percorso contiene due punti (:) o è in un formato non valido.
Memoria insufficiente per scrivere la 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 FileList.txtin , 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.
Note
Il WriteAllText metodo apre un file, lo scrive e quindi 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 .
| Per | Vedi |
|---|---|
| Scrivere testo in un file | Procedura: Scrivere testo in file |
| Aggiungere testo a un file | Procedura: Aggiungere a file di testo |