FileInfo.CreateText-Methode

Erstellt einen StreamWriter, der eine neue Textdatei erstellt und in diese schreibt.

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

Syntax

'Declaration
Public Function CreateText As StreamWriter
'Usage
Dim instance As FileInfo
Dim returnValue As StreamWriter

returnValue = instance.CreateText

public StreamWriter CreateText ()

public:
StreamWriter^ CreateText ()

public StreamWriter CreateText ()

public function CreateText () : StreamWriter

Rückgabewert

Ein neuer StreamWriter.

Ausnahmen

Ausnahmetyp	Bedingung
UnauthorizedAccessException	Der Dateiname ist ein Verzeichnis.
IOException	Der Datenträger ist schreibgeschützt.
SecurityException	Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

Hinweise

Standardmäßig wird allen Benutzern vollständiger Lese- und Schreibzugriff für alle neuen Dateien gewährt.

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
Lesen aus einer Textdatei.	Gewusst wie: Lesen aus einer Textdatei
Anfügen von Text an eine Datei.	Gewusst wie: Öffnen und Anfügen an eine Protokolldatei File.AppendText FileInfo.AppendText
Kopieren einer Datei.	File.Copy FileInfo.CopyTo
Umbenennen oder Verschieben einer Datei.	File.Move FileInfo.MoveTo
Löschen einer Datei.	File.Delete FileInfo.Delete
Lesen aus einer Binärdatei.	Gewusst wie: Lesen und Schreiben einer neu erstellten Datendatei
Schreiben in eine Binärdatei.	Gewusst wie: Lesen und Schreiben einer neu erstellten Datendatei
Erstellen eines Verzeichnisses.	CreateDirectory Directory

Beispiel

Das folgende Beispiel veranschaulicht die CreateText-Methode.

Imports System
Imports System.IO
Imports System.Text

Public Class Test

    Public Shared Sub Main()
        Dim path As String = "c:\temp\MyTest.txt"
        Dim fi As FileInfo = New FileInfo(path)

        If fi.Exists = False Then
            'Create a file to write to.
            Dim sw As StreamWriter = fi.CreateText()
            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 = fi.OpenText()

        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";
        FileInfo fi = new FileInfo(path);

        if (!fi.Exists) 
        {
            //Create a file to write to.
            using (StreamWriter sw = fi.CreateText()) 
            {
                sw.WriteLine("Hello");
                sw.WriteLine("And");
                sw.WriteLine("Welcome");
            }
        }

        //Open the file to read from.
        using (StreamReader sr = fi.OpenText()) 
        {
            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";
   FileInfo^ fi = gcnew FileInfo( path );
   if (  !fi->Exists )
   {
      //Create a file to write to.
      StreamWriter^ sw = fi->CreateText();
      try
      {
         sw->WriteLine( "Hello" );
         sw->WriteLine( "And" );
         sw->WriteLine( "Welcome" );
      }
      finally
      {
         if ( sw )
            delete (IDisposable^)sw;
      }
   }

   //Open the file to read from.
   StreamReader^ sr = fi->OpenText();
   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";
        FileInfo fi = new FileInfo(path);

        if (!(fi.get_Exists())) {
            //Create a file to write to.
            StreamWriter sw = fi.CreateText();

            try {
                sw.WriteLine("Hello");
                sw.WriteLine("And");
                sw.WriteLine("Welcome");
            }
            finally {
                sw.Dispose();
            }
        }

        //Open the file to read from.
        StreamReader sr = fi.OpenText();

        try {
            String s = "";

            while ((s = sr.ReadLine()) != null) {
                Console.WriteLine(s);
            }
        }
        finally {
            sr.Dispose();
        }
    } //main
} //Test

.NET Framework-Sicherheit

• FileIOPermission  zum Lesen und Schreiben von Dateien. Zugeordnete Enumerationen: FileIOPermissionAccess.Read, 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

FileInfo-Klasse
FileInfo-Member
System.IO-Namespace
StreamWriter

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