File.CreateText(String) Metodo

Definizione

Spazio dei nomi:
System.IO
Assembly:
mscorlib.dll, System.IO.FileSystem.dll
Assembly:
mscorlib.dll
Assembly:
System.IO.FileSystem.dll
Assembly:
netstandard.dll

Crea o apre un file per la scrittura di testo con codifica UTF-8. Se il file esiste già, il relativo contenuto viene sostituito.

public:
 static System::IO::StreamWriter ^ CreateText(System::String ^ path);
public static System.IO.StreamWriter CreateText(string path);
static member CreateText : string -> System.IO.StreamWriter
Public Shared Function CreateText (path As String) As StreamWriter

Parametri

path
String

File da aprire per la scrittura.

Valori restituiti

StreamWriter

Oggetto StreamWriter che scrive nel file specificato utilizzando la codifica UTF-8.

Eccezioni

UnauthorizedAccessException

Il chiamante non dispone dell'autorizzazione richiesta.

oppure

path è stato specificato un file di sola lettura.

oppure

path è stato specificato un file nascosto.

ArgumentException

.NET Framework e versioni di .NET Core precedenti alla 2.1: path è una stringa di lunghezza zero, contiene solo spazi vuoti o contiene uno o più caratteri non validi. È possibile eseguire una query per individuare caratteri non validi usando il metodo GetInvalidPathChars().

ArgumentNullException

path è null.

PathTooLongException

Il percorso, il nome file specificato o entrambi superano la lunghezza massima definita dal sistema.

DirectoryNotFoundException

Il percorso specificato non è valido( ad esempio, si trova in un'unità non mappata).

NotSupportedException

path è in un formato non valido.

Esempio

Nell'esempio seguente viene creato un file per la scrittura e la lettura di testo.

using System;
using System.IO;

class Test
{
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";
        if (!File.Exists(path))
        {
            // Create a file to write to.
            using (StreamWriter sw = File.CreateText(path))
            {
                sw.WriteLine("Hello");
                sw.WriteLine("And");
                sw.WriteLine("Welcome");
            }	
        }

        // Open the file to read from.
        using (StreamReader sr = File.OpenText(path))
        {
            string s = "";
            while ((s = sr.ReadLine()) != null)
            {
                Console.WriteLine(s);
            }
        }
    }
}

open System.IO

let path = @"c:\temp\MyTest.txt"

if File.Exists path |> not then
    // Create a file to write to.
    use sw = File.CreateText path
    sw.WriteLine "Hello"
    sw.WriteLine "Welcome"

// Open the file to read from.
do
    use sr = File.OpenText path
    let mutable s = sr.ReadLine()

    while isNull s |> not do
        printfn $"{s}"
        s <- sr.ReadLine()

Imports System.IO
Imports System.Text

Public Class Test
  Public Shared Sub Main()
    Dim path As String = "c:\temp\MyTest.txt"

    If Not File.Exists(path) Then
      ' Create a file to write to. 
      Using sw As StreamWriter = File.CreateText(path)
        sw.WriteLine("Hello")
        sw.WriteLine("And")
        sw.WriteLine("Welcome")
      End Using
    End If

    ' Open the file to read from. 
    Using sr As StreamReader = File.OpenText(path)
      Do While sr.Peek() >= 0
        Console.WriteLine(sr.ReadLine())
      Loop
    End Using

  End Sub
End Class

Commenti

Questo metodo equivale all'overload del StreamWriter(String, Boolean) costruttore con il append parametro impostato su false. Se il file specificato da path non esiste, viene creato. Se il file esiste, il relativo contenuto viene sostituito. I thread aggiuntivi possono leggere il file mentre è aperto.

Il path parametro è autorizzato a specificare informazioni relative o assolute sul percorso. Le informazioni sul percorso relative sono interpretate come relative alla directory di lavoro corrente. Per ottenere la directory di lavoro corrente, vedere GetCurrentDirectory.

Per un elenco delle attività di I/O comuni, vedere Attività di I/O comuni.

Si applica a

Vedi anche