File.CreateText(String) Methode

Definition

Namespace:
System.IO
Assemblys:
mscorlib.dll, System.IO.FileSystem.dll
Assembly:
mscorlib.dll
Assembly:
System.IO.FileSystem.dll
Assembly:
netstandard.dll

Erstellt oder öffnet eine Datei zum Schreiben von UTF-8-codierten Text. Wenn die Datei bereits vorhanden ist, werden die Inhalte ersetzt.

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

Parameter

path
String

Die Datei, die zum Schreiben geöffnet werden soll.

Gibt zurück

StreamWriter

A StreamWriter that writes to the specified file using UTF-8 encoding.

Ausnahmen

UnauthorizedAccessException

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

-oder-

path eine Datei angegeben, die schreibgeschützt ist.

-oder-

path eine ausgeblendete Datei angegeben.

ArgumentException

.NET Framework- und .NET Core-Versionen, die älter als 2.1 sind: path eine leere Zeichenfolge, enthält nur Leerzeichen oder enthält mindestens ein ungültiges Zeichen. Sie können ungültige Zeichen mithilfe der GetInvalidPathChars() Methode abfragen.

ArgumentNullException

path ist null.

PathTooLongException

Der angegebene Pfad, der Dateiname oder beide überschreiten die vom System definierte maximale Länge.

DirectoryNotFoundException

Der angegebene Pfad ist ungültig (z. B. auf einem nicht zugeordneten Laufwerk).

NotSupportedException

path ist in einem ungültigen Format vorhanden.

Beispiele

Im folgenden Beispiel wird eine Datei zum Schreiben und Lesen von Text erstellt.

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

Hinweise

Diese Methode entspricht der StreamWriter(String, Boolean) Konstruktorüberladung, auf die der append Parameter festgelegt ist false. Wenn die angegebene path Datei nicht vorhanden ist, wird sie erstellt. Wenn die Datei vorhanden ist, werden die Inhalte ersetzt. Zusätzliche Threads dürfen die Datei lesen, während sie geöffnet ist.

Der path Parameter darf relative oder absolute Pfadinformationen angeben. Relative Pfadinformationen werden relativ zum aktuellen Arbeitsverzeichnis interpretiert. Informationen zum Abrufen des aktuellen Arbeitsverzeichnisses finden Sie unter GetCurrentDirectory.

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter "Allgemeine E/A-Aufgaben".

Gilt für:

Weitere Informationen