File.CreateText(String) Metoda

Definicja

Tworzy lub otwiera plik do pisania tekstu zakodowanego w formacie UTF-8.Creates or opens a file for writing UTF-8 encoded text. Jeśli plik już istnieje, jego zawartość jest zastępowana.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

Parametry

path
String

Plik, który ma zostać otwarty do zapisu.The file to be opened for writing.

Zwraca

StreamWriter zapisywania do określonego pliku przy użyciu kodowania UTF-8.A StreamWriter that writes to the specified file using UTF-8 encoding.

Wyjątki

Element wywołujący nie ma wymaganego uprawnienia.The caller does not have the required permission.

— lub —-or- path określony plik jest tylko do odczytu.path specified a file that is read-only.

— lub —-or- path określono nieukryty plik.path specified a file that is hidden.

path jest ciągiem o zerowej długości, zawiera tylko znak odstępu lub zawiera jeden lub więcej nieprawidłowych znaków zdefiniowanych przez InvalidPathChars.path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

Parametr path ma wartość null.path is null.

Podana ścieżka, nazwa pliku lub obie przekraczają maksymalną długość zdefiniowaną przez system.The specified path, file name, or both exceed the system-defined maximum length.

Określona ścieżka jest nieprawidłowa (na przykład znajduje się na dysku niezamapowanym).The specified path is invalid (for example, it is on an unmapped drive).

path ma nieprawidłowy format.path is in an invalid format.

Przykłady

Poniższy przykład tworzy plik do pisania i odczytywania tekstu.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

Uwagi

Ta metoda jest równoważna z przeciążeniem konstruktora StreamWriter(String, Boolean) z parametrem append ustawionym na false.This method is equivalent to the StreamWriter(String, Boolean) constructor overload with the append parameter set to false. Jeśli plik określony przez path nie istnieje, zostanie utworzony.If the file specified by path does not exist, it is created. Jeśli plik istnieje, jego zawartość jest zastępowana.If the file does exist, its contents are overwritten. Dodatkowe wątki mogą odczytywać plik, gdy jest otwarty.Additional threads are permitted to read the file while it is open.

Parametr path może określać informacje o ścieżce względnej lub bezwzględnej.The path parameter is permitted to specify relative or absolute path information. Informacje o ścieżce względnej są interpretowane jako względne w stosunku do bieżącego katalogu roboczego.Relative path information is interpreted as relative to the current working directory. Aby uzyskać bieżący katalog roboczy, zobacz GetCurrentDirectory.To obtain the current working directory, see GetCurrentDirectory.

Aby uzyskać listę typowych zadań we/wy, zobacz typowe zadania we/wy.For a list of common I/O tasks, see Common I/O Tasks.

Dotyczy

Zobacz też