File.CreateText(String) Metodo

Definizione

Spazio dei nomi:

System.IO

Assembly:

System.Runtime.dll

Origine:

File.cs

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.

Restituisce

StreamWriter

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

Eccezioni

UnauthorizedAccessException

Il chiamante non dispone dell'autorizzazione richiesta.

-oppure-

path specifica un file di sola lettura.

-oppure-

path specifica un file nascosto.

ArgumentException

.NET Framework e versioni di .NET Core precedenti a 2.1: path è una stringa di lunghezza zero, contiene solo spazio vuoto o contiene uno o più caratteri non validi. È possibile cercare i caratteri non validi usando il metodo GetInvalidPathChars().

ArgumentNullException

path è null.

PathTooLongException

Il percorso specificato, il nome file 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

Il formato di path non è valido.

Esempio

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

using namespace System;
using namespace System::IO;
int main()
{
   String^ path = "c:\\temp\\MyTest.txt";
   if ( !File::Exists( path ) )
   {
      
      // Create a file to write to.
      StreamWriter^ sw = File::CreateText( path );
      try
      {
         sw->WriteLine( "Hello" );
         sw->WriteLine( "And" );
         sw->WriteLine( "Welcome" );
      }
      finally
      {
         if ( sw )
                  delete (IDisposable^)sw;
      }
   }
   
   // Open the file to read from.
   StreamReader^ sr = File::OpenText( path );
   try
   {
      String^ s = "";
      while ( s = sr->ReadLine() )
      {
         Console::WriteLine( s );
      }
   }
   finally
   {
      if ( sr )
            delete (IDisposable^)sr;
   }
}

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 sono autorizzati a leggere il file mentre è aperto.

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

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

Vedi anche

• File e Stream I/O
• Lettura del testo da un file
• Procedura: Scrivere un testo in un file
• Procedura: Leggere e scrivere su un file di dati appena creato