File.CreateText(String) File.CreateText(String) File.CreateText(String) File.CreateText(String) Method

Definizione

Crea o apre un file per la scrittura di testo con codifica UTF-8.Creates or opens a file for writing UTF-8 encoded text. Se il file esiste, il relativo contenuto verrà sovrascritto.If the file already exists, its contents are overwritten.

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 String String String

File da aprire per la scrittura.The file to be opened for writing.

Restituisce

Oggetto StreamWriter che scrive nel file specificato usando la codifica UTF-8.A StreamWriter that writes to the specified file using UTF-8 encoding.

Eccezioni

Il chiamante non dispone dell'autorizzazione richiesta.The caller does not have the required permission.

-oppure--or- path specifica un file di sola lettura.path specified a file that is read-only.

-oppure--or- path specifica un file nascosto.path specified a file that is hidden.

path è una stringa di lunghezza zero, contiene solo spazi vuoti o contiene uno o più caratteri non validi definiti da InvalidPathChars.path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

Il percorso specificato, il nome file o entrambi superano la lunghezza massima definita dal sistema.The specified path, file name, or both exceed the system-defined maximum length.

Il percorso specificato non è valido, ad esempio si trova in un'unità non mappata.The specified path is invalid (for example, it is on an unmapped drive).

Il formato di path non è valido.path is in an invalid format.

Esempi

Nell'esempio seguente viene creato un file per la scrittura e la lettura di testo.The following example creates a file for text writing and reading.

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);
            }
        }
    }
}
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 è equivalente all'overload StreamWriter(String, Boolean) del costruttore con il append parametro impostato su false.This method is equivalent to the StreamWriter(String, Boolean) constructor overload with the append parameter set to false. Se il file specificato da path non esiste, viene creato.If the file specified by path does not exist, it is created. Se il file esiste, il relativo contenuto viene sovrascritto.If the file does exist, its contents are overwritten. Ai thread aggiuntivi è consentito leggere il file mentre è aperto.Additional threads are permitted to read the file while it is open.

Al path parametro è consentito specificare informazioni sul percorso relativo o assoluto.The path parameter is permitted to specify relative or absolute path information. Le informazioni sul percorso relativo vengono interpretate in relazione alla directory di lavoro corrente.Relative path information is interpreted as relative to the current working directory. Per ottenere la directory di lavoro corrente, GetCurrentDirectoryvedere.To obtain the current working directory, see GetCurrentDirectory.

Per un elenco delle attività di I/O comuni, vedere attività di i/o comuni.For a list of common I/O tasks, see Common I/O Tasks.

Sicurezza

FileIOPermission
per la scrittura nel file specificato.for writing to the specified file. Enumerazione associata:WriteAssociated enumeration: Write

Si applica a

Vedi anche