File.CreateText(String) Methode

Definition

Erstellt oder öffnet eine Datei zum Schreiben von UTF-8 codiertem Text.Creates or opens a file for writing UTF-8 encoded text. Wenn die Datei bereits vorhanden ist, werden deren Inhalte überschrieben.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

Parameter

path
String

Die Datei, die zum Schreiben geöffnet werden soll.The file to be opened for writing.

Gibt zurück

Ein StreamWriter, der unter Verwendung der UTF-8-Codierung in die angegebene Datei schreibt.A StreamWriter that writes to the specified file using UTF-8 encoding.

Ausnahmen

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.The caller does not have the required permission.

- oder --or- path hat eine schreibgeschützte Datei angegeben.path specified a file that is read-only.

- oder --or- path hat eine schreibgeschützte Datei angegeben.path specified a file that is hidden.

path ist eine leere Zeichenfolge, enthält nur Leerzeichen oder enthält mindestens ein ungültiges Zeichen gemäß der Definition von InvalidPathChars.path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

path ist null.path is null.

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.The specified path, file name, or both exceed the system-defined maximum length.

Der angegebene Pfad ist ungültig (er befindet sich z. B. auf einem nicht zugeordneten Laufwerk).The specified path is invalid (for example, it is on an unmapped drive).

path weist ein ungültiges Format auf.path is in an invalid format.

Beispiele

Im folgenden Beispiel wird eine Datei für das Schreiben und Lesen von Text erstellt.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

Hinweise

Diese Methode entspricht der StreamWriter(String, Boolean)-Konstruktorüberladung, bei der der append-Parameter auf falsefestgelegt ist.This method is equivalent to the StreamWriter(String, Boolean) constructor overload with the append parameter set to false. Wenn die Datei durch angegeben path nicht vorhanden ist, wird er erstellt.If the file specified by path does not exist, it is created. Wenn die Datei vorhanden ist, wird Ihr Inhalt überschrieben.If the file does exist, its contents are overwritten. Zusätzliche Threads sind berechtigt, die Datei zu lesen, während Sie geöffnet ist.Additional threads are permitted to read the file while it is open.

Der path-Parameter darf relative oder absolute Pfadinformationen angeben.The path parameter is permitted to specify relative or absolute path information. Relative Pfadinformationen werden als relativ zum aktuellen Arbeitsverzeichnis interpretiert.Relative path information is interpreted as relative to the current working directory. Informationen zum Abrufen des aktuellen Arbeitsverzeichnisses finden Sie unter GetCurrentDirectory.To obtain the current working directory, see GetCurrentDirectory.

Eine Liste der allgemeinen e/a-Aufgaben finden Sie unter Allgemeine e/a-Aufgaben.For a list of common I/O tasks, see Common I/O Tasks.

Sicherheit

FileIOPermission
zum Schreiben in die angegebene Datei.for writing to the specified file. Zugehörige Enumeration: WriteAssociated enumeration: Write

Gilt für:

Siehe auch