File.CreateText(String) Metoda

Definicja

Przestrzeń nazw:

System.IO

Zestaw:

System.Runtime.dll

Źródło:

File.cs

Tworzy lub otwiera plik do zapisywania tekstu zakodowanego w formacie UTF-8. Jeśli plik już istnieje, jego zawartość jest zastępowana.

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.

Zwraca

StreamWriter

Element StreamWriter , który zapisuje w określonym pliku przy użyciu kodowania UTF-8.

Wyjątki

UnauthorizedAccessException

Obiekt wywołujący nie posiada wymaganych uprawnień.

-lub-

path określony plik, który jest tylko do odczytu.

-lub-

path określono plik, który jest ukryty.

ArgumentException

.NET Framework i .NET Core w wersjach starszych niż 2.1: path jest ciągiem o zerowej długości, zawiera tylko biały znak lub zawiera co najmniej jeden nieprawidłowy znak. Zapytania dotyczące nieprawidłowych znaków można wykonać przy użyciu GetInvalidPathChars() metody .

ArgumentNullException

path to null.

PathTooLongException

Podana ścieżka, nazwa pliku lub obie przekraczają maksymalną długość zdefiniowaną przez system.

DirectoryNotFoundException

Określona ścieżka jest nieprawidłowa (na przykład znajduje się na niezamapowanym dysku).

NotSupportedException

path jest w nieprawidłowym formacie.

Przykłady

W poniższym przykładzie tworzony jest plik do zapisywania tekstu i odczytywania.

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

Uwagi

Ta metoda jest równoważna przeciążeniu konstruktora StreamWriter(String, Boolean) z parametrem ustawionym append na falsewartość . Jeśli plik określony przez path program nie istnieje, zostanie utworzony. Jeśli plik istnieje, jego zawartość zostanie zastąpiona. Podczas otwierania pliku mogą być odczytywane dodatkowe wątki.

Parametr path może określać informacje o ścieżce względnej lub bezwzględnej. Informacje o ścieżce względnej są interpretowane jako względne w stosunku do bieżącego katalogu roboczego. Aby uzyskać bieżący katalog roboczy, zobacz GetCurrentDirectory.

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz też

• We/Wy pliku i strumienia
• Odczytywanie tekstu z pliku
• Instrukcje: Zapisywanie tekstu w pliku
• Instrukcje: Odczyt i zapis we właśnie utworzonym pliku danych