File.CreateText-Methode

Artikel
08/20/2007

Erstellt oder öffnet eine Datei zum Schreiben von UTF-8 codiertem Text.

Namespace: System.IO
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Shared Function CreateText ( _
    path As String _
) As StreamWriter
'Usage
Dim path As String
Dim returnValue As StreamWriter

returnValue = File.CreateText(path)

public static StreamWriter CreateText (
    string path
)

public:
static StreamWriter^ CreateText (
    String^ path
)

public static StreamWriter CreateText (
    String path
)

public static function CreateText (
    path : String
) : StreamWriter

Parameter

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

Rückgabewert

Ein StreamWriter, der unter Verwendung der UTF-8-Codierung in die angegebene Datei schreibt.

Ausnahmen

Ausnahmetyp	Bedingung
UnauthorizedAccessException	Der Aufrufer verfügt nicht über die erforderliche Berechtigung.
ArgumentException	path ist eine Zeichenfolge der Länge 0, besteht nur aus Leerraum oder enthält ein oder mehr durch InvalidPathChars definierte ungültige Zeichen.
ArgumentNullException	path ist NULL (Nothing in Visual Basic).
PathTooLongException	Der angegebene Pfad und/oder der Dateiname überschreiten die vom System vorgegebene Höchstlänge. Beispielsweise müssen Pfade auf Windows-Plattformen weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen haben.
DirectoryNotFoundException	Der angegebene Pfad ist ungültig (z. B. befindet er sich auf einem nicht zugeordneten Laufwerk).
NotSupportedException	Das Format von path ist ungültig.

Hinweise

Diese Methode entspricht der StreamWriter(String,Boolean)-Konstruktorüberladung, wobei der append-Parameter auf false festgelegt ist. Wenn die durch path angegebene Datei nicht vorhanden ist, wird sie erstellt. Wenn die Datei vorhanden ist, wird ihr Inhalt überschrieben. Zusätzliche Threads dürfen die geöffnete Datei lesen.

Mit dem path-Parameter dürfen relative oder absolute Pfadinformationen angegeben werden. Relative Pfadinformationen werden relativ zum aktuellen Arbeitsverzeichnis interpretiert. Informationen über das Abrufen des aktuellen Arbeitsverzeichnisses finden Sie unter GetCurrentDirectory.

Ein Beispiel für die Verwendung dieser Klasse finden Sie im Beispielabschnitt. In der folgenden Tabelle sind Beispiele für andere typische oder verwandte E/A-Aufgaben aufgeführt.

Aufgabe	Beispiel in diesem Thema
Schreiben in eine Textdatei.	Gewusst wie: Schreiben von Text in eine Datei
Aus einer Textdatei lesen.	Gewusst wie: Lesen aus einer Textdatei
Text an eine Datei anfügen.	Gewusst wie: Öffnen und Anfügen an eine Protokolldatei File.AppendText FileInfo.AppendText
Eine Datei kopieren.	File.Copy FileInfo.CopyTo
Eine Datei umbenennen oder verschieben.	File.Move FileInfo.MoveTo
Eine Datei löschen.	File.Delete FileInfo.Delete
Aus einer Binärdatei lesen.	Gewusst wie: Lesen und Schreiben einer neu erstellten Datendatei
In eine Binärdatei schreiben.	Gewusst wie: Lesen und Schreiben einer neu erstellten Datendatei
Erstellen eines Verzeichnisses.	CreateDirectory Directory

Beispiel

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

Imports System
Imports System.IO
Imports System.Text

Public Class Test
    Public Shared Sub Main()
        Dim path As String = "c:\temp\MyTest.txt"
        If File.Exists(path) = False Then
            ' Create a file to write to.
            Dim sw As StreamWriter = File.CreateText(path)
            sw.WriteLine("Hello")
            sw.WriteLine("And")
            sw.WriteLine("Welcome")
            sw.Flush()
            sw.Close()
        End If

        ' Open the file to read from.
        Dim sr As StreamReader = File.OpenText(path)
        Do While sr.Peek() >= 0
            Console.WriteLine(sr.ReadLine())
        Loop
        sr.Close()
    End Sub
End Class

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);
            }
        }
    }
}

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;
   }
}

import System.*;
import System.IO.*;

class Test
{
    public static void main(String[] args)
    {
        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 {
                sw.Dispose();
            }
        }
        // Open the file to read from.
        StreamReader sr = File.OpenText(path);
        try {
            String s = "";
            while ((s = sr.ReadLine()) != null) {
                Console.WriteLine(s);
            }
        }
        finally {
            sr.Dispose();
        }
        
    } //main
} //Test

.NET Framework-Sicherheit

FileIOPermission zum Schreiben in die angegebene Datei. Zugeordnete Enumeration: FileIOPermissionAccess.Write

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

File-Klasse
File-Member
System.IO-Namespace

Weitere Ressourcen

Datei- und Stream-E/A
Gewusst wie: Lesen aus einer Textdatei
Gewusst wie: Schreiben von Text in eine Datei
Grundlegende Datei-E/A
Gewusst wie: Lesen und Schreiben einer neu erstellten Datendatei

Freigeben über