File.Create Methode

Definition

Namespace:

System.IO

Assembly:

System.Runtime.dll

Erstellt eine Datei im angegebenen Pfad oder kürzt und überschreibt sie.

Überlädt

Create(String)	Erstellt oder abschneidet und überschreibt eine Datei im angegebenen Pfad.
Create(String, Int32)	Erstellt oder abschneidet und überschreibt eine Datei im angegebenen Pfad, wobei eine Puffergröße angegeben wird.
Create(String, Int32, FileOptions)	Erstellt oder überschreibt eine Datei im angegebenen Pfad und legt eine Puffergröße sowie Optionen fest, die beschreiben, wie die Datei erstellt oder überschrieben werden soll.

Create(String)

Quelle:

File.cs

Erstellt oder abschneidet und überschreibt eine Datei im angegebenen Pfad.

public:
 static System::IO::FileStream ^ Create(System::String ^ path);

public static System.IO.FileStream Create (string path);

static member Create : string -> System.IO.FileStream

Public Shared Function Create (path As String) As FileStream

Parameter

path

String

Der Pfad und der Name der zu erstellenden Datei.

Gibt zurück

FileStream

Ein FileStream, der Lese- und Schreibzugriff auf die in path angegebene Datei bereitstellt.

Ausnahmen

UnauthorizedAccessException

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

- oder -

path hat eine schreibgeschützte Datei angegeben.

- oder -

path hat eine schreibgeschützte Datei angegeben.

ArgumentException

.NET Framework und .NET Core-Versionen älter als 2.1: path ist eine Zeichenfolge der Länge null, enthält nur Leerzeichen oder enthält ein oder mehrere ungültige Zeichen. Sie können Abfragen für ungültige Zeichen mithilfe der GetInvalidPathChars()-Methode ausführen.

ArgumentNullException

path ist null.

PathTooLongException

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.

DirectoryNotFoundException

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

IOException

Beim Erstellen der Datei ist ein E/A-Fehler aufgetreten.

NotSupportedException

path weist ein ungültiges Format auf.

Beispiele

Im folgenden Beispiel wird eine Datei im angegebenen Pfad erstellt, einige Informationen in die Datei geschrieben und aus der Datei gelesen.

using namespace System;
using namespace System::IO;
using namespace System::Text;

int main()
{
   String^ path = "c:\\temp\\MyTest.txt";
   
   // Create the file, or overwrite if the file exists.
   FileStream^ fs = File::Create( path );
   try
   {
      array<Byte>^info = (gcnew UTF8Encoding( true ))->GetBytes( "This is some text in the file." );
      
      // Add some information to the file.
      fs->Write( info, 0, info->Length );
   }
   finally
   {
      if ( fs )
            delete (IDisposable^)fs;
   }

   // Open the stream and read it back.
   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;
using System.Text;

class Test
{
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";

        try
        {
            // Create the file, or overwrite if the file exists.
            using (FileStream fs = File.Create(path))
            {
                byte[] info = new UTF8Encoding(true).GetBytes("This is some text in the file.");
                // Add some information to the file.
                fs.Write(info, 0, info.Length);
            }

            // Open the stream and read it back.
            using (StreamReader sr = File.OpenText(path))
            {
                string s = "";
                while ((s = sr.ReadLine()) != null)
                {
                    Console.WriteLine(s);
                }
            }
        }

        catch (Exception ex)
        {
            Console.WriteLine(ex.ToString());
        }
    }
}

open System.IO
open System.Text

let path = @"c:\temp\MyTest.txt"

// Create the file, or overwrite if the file exists.
do
    use fs = File.Create path

    let info =
        UTF8Encoding(true)
            .GetBytes "This is some text in the file."
    // Add some information to the file.
    fs.Write(info, 0, info.Length)

// Open the stream and read it back.
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"

    Try
      ' Create the file, or overwrite if the file exists.
      Using fs As FileStream = File.Create(path)
        Dim info As Byte() = New UTF8Encoding(True).GetBytes("This is some text in the file.")

        ' Add some information to the file.
        fs.Write(info, 0, info.Length)
      End Using

      ' Open the stream and read it back. 
      Using sr As StreamReader = File.OpenText(path)
        Do While sr.Peek() >= 0
          Console.WriteLine(sr.ReadLine())
        Loop
      End Using

    Catch ex As Exception
      Console.WriteLine(ex.ToString())
    End Try

  End Sub
End Class

Hinweise

Das FileStream von dieser Methode erstellte Objekt hat den Standardwert FileShareNone. Kein anderer Prozess oder Code kann auf die erstellte Datei zugreifen, bis das ursprüngliche Dateihandle geschlossen wird.

Diese Methode entspricht der Create(String, Int32) Methodenüberladung mit der Standardpuffergröße von 4.096 Bytes.

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.

Wenn die angegebene Datei nicht vorhanden ist, wird sie erstellt. wenn es vorhanden ist und nicht schreibgeschützt ist, werden die Inhalte gelöscht und überschrieben.

Standardmäßig wird allen Benutzern vollständiger Lese-/Schreibzugriff auf neue Dateien gewährt. Die Datei wird mit Lese-/Schreibzugriff geöffnet und muss geschlossen werden, bevor sie von einer anderen Anwendung geöffnet werden kann.

Eine Liste der allgemeinen E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Weitere Informationen

• Datei- und Stream-E/A
• Lesen von Text aus einer Datei
• How to: Schreiben von Text in eine Datei
• How to: Vorgehensweise: Lesen von bzw. Schreiben in eine neu erstellte Datendatei

Create(String, Int32)

Quelle:

File.cs

Erstellt oder abschneidet und überschreibt eine Datei im angegebenen Pfad, wobei eine Puffergröße angegeben wird.

public:
 static System::IO::FileStream ^ Create(System::String ^ path, int bufferSize);

public static System.IO.FileStream Create (string path, int bufferSize);

static member Create : string * int -> System.IO.FileStream

Public Shared Function Create (path As String, bufferSize As Integer) As FileStream

Parameter

path

String

Der Pfad und der Name der zu erstellenden Datei.

bufferSize

Int32

Die Anzahl der für Lese- und Schreibvorgänge in die Datei gepufferten Bytes.

Gibt zurück

FileStream

Ein FileStream mit der angegebenen Puffergröße, der Lese-/Schreibzugriff auf die in path angegebene Datei bereitstellt.

Ausnahmen

UnauthorizedAccessException

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

- oder -

path hat eine schreibgeschützte Datei angegeben.

- oder -

path hat eine schreibgeschützte Datei angegeben.

ArgumentException

.NET Framework und .NET Core-Versionen älter als 2.1: path ist eine Zeichenfolge der Länge null, enthält nur Leerzeichen oder enthält ein oder mehrere ungültige Zeichen. Sie können Abfragen für ungültige Zeichen mithilfe der GetInvalidPathChars()-Methode ausführen.

ArgumentNullException

path ist null.

PathTooLongException

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.

DirectoryNotFoundException

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

IOException

Beim Erstellen der Datei ist ein E/A-Fehler aufgetreten.

NotSupportedException

path weist ein ungültiges Format auf.

Beispiele

Im folgenden Beispiel wird eine Datei mit der angegebenen Puffergröße erstellt.

using namespace System;
using namespace System::IO;
using namespace System::Text;

int main()
{
   String^ path = "c:\\temp\\MyTest.txt";
   
   // Create the file, or overwrite if the file exists.
   FileStream^ fs = File::Create( path, 1024 );
   try
   {
      array<Byte>^info = (gcnew UTF8Encoding( true ))->GetBytes( "This is some text in the file." );
      
      // Add some information to the file.
      fs->Write( info, 0, info->Length );
   }
   finally
   {
      if ( fs )
            delete (IDisposable^)fs;
   }

   // Open the stream and read it back.
   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;
using System.Text;

class Test
{
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";

        // Create the file, or overwrite if the file exists.
        using (FileStream fs = File.Create(path, 1024))
        {
            byte[] info = new UTF8Encoding(true).GetBytes("This is some text in the file.");
            // Add some information to the file.
            fs.Write(info, 0, info.Length);
        }

        // Open the stream and read it back.
        using (StreamReader sr = File.OpenText(path))
        {
            string s = "";
            while ((s = sr.ReadLine()) != null)
            {
                Console.WriteLine(s);
            }
        }
    }
}

open System.IO
open System.Text

let path = @"c:\temp\MyTest.txt"

// Create the file, or overwrite if the file exists.
do
    use fs = File.Create(path, 1024)

    let info =
        UTF8Encoding(true)
            .GetBytes "This is some text in the file."
    // Add some information to the file.
    fs.Write(info, 0, info.Length)

// Open the stream and read it back.
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"

    Try
      ' Create the file, or overwrite if the file exists.
      Using fs As FileStream = File.Create(path, 1024)
        Dim info As Byte() = New UTF8Encoding(True).GetBytes("This is some text in the file.")

        ' Add some information to the file.
        fs.Write(info, 0, info.Length)
      End Using

      ' Open the stream and read it back. 
      Using sr As StreamReader = File.OpenText(path)
        Do While sr.Peek() >= 0
          Console.WriteLine(sr.ReadLine())
        Loop
      End Using

    Catch ex As Exception
      Console.WriteLine(ex.ToString())
    End Try

  End Sub
End Class

Hinweise

Das FileStream von dieser Methode erstellte Objekt hat den Standardwert FileShareNone. Kein anderer Prozess oder Code kann auf die erstellte Datei zugreifen, bis das ursprüngliche Dateihandle geschlossen wird.

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.

Diese Methode entspricht der FileStream(String, FileMode, FileAccess, FileShare, Int32) Konstruktorüberladung. Wenn die angegebene Datei nicht vorhanden ist, wird sie erstellt. wenn es vorhanden ist und nicht schreibgeschützt ist, werden die Inhalte ersetzt.

Standardmäßig wird allen Benutzern vollständiger Lese-/Schreibzugriff auf neue Dateien gewährt. Die Datei wird mit Lese-/Schreibzugriff geöffnet und muss geschlossen werden, bevor sie von einer anderen Anwendung geöffnet werden kann.

Eine Liste der allgemeinen E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Weitere Informationen

• Datei- und Stream-E/A
• Lesen von Text aus einer Datei
• How to: Schreiben von Text in eine Datei
• How to: Vorgehensweise: Lesen von bzw. Schreiben in eine neu erstellte Datendatei

Create(String, Int32, FileOptions)

Quelle:

File.cs

Erstellt oder überschreibt eine Datei im angegebenen Pfad und legt eine Puffergröße sowie Optionen fest, die beschreiben, wie die Datei erstellt oder überschrieben werden soll.

public:
 static System::IO::FileStream ^ Create(System::String ^ path, int bufferSize, System::IO::FileOptions options);

public static System.IO.FileStream Create (string path, int bufferSize, System.IO.FileOptions options);

static member Create : string * int * System.IO.FileOptions -> System.IO.FileStream

Public Shared Function Create (path As String, bufferSize As Integer, options As FileOptions) As FileStream

Parameter

path

String

Der Pfad und der Name der zu erstellenden Datei.

bufferSize

Int32

Die Anzahl der für Lese- und Schreibvorgänge in die Datei gepufferten Bytes.

options

FileOptions

Einer der FileOptions-Werte, der beschreibt, wie die Datei erstellt oder überschrieben werden soll.

Gibt zurück

FileStream

Eine neue Datei mit der angegebenen Puffergröße.

Ausnahmen

UnauthorizedAccessException

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

- oder -

path hat eine schreibgeschützte Datei angegeben.

- oder -

path hat eine schreibgeschützte Datei angegeben.

ArgumentException

.NET Framework und .NET Core-Versionen älter als 2.1: path ist eine Zeichenfolge der Länge null, enthält nur Leerzeichen oder enthält ein oder mehrere ungültige Zeichen. Sie können Abfragen für ungültige Zeichen mithilfe der GetInvalidPathChars()-Methode ausführen.

ArgumentNullException

path ist null.

PathTooLongException

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.

DirectoryNotFoundException

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

IOException

Beim Erstellen der Datei ist ein E/A-Fehler aufgetreten.

NotSupportedException

path weist ein ungültiges Format auf.

Hinweise

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.

Diese Methode entspricht der FileStream(String, FileMode, FileAccess, FileShare, Int32) Konstruktorüberladung. Wenn die angegebene Datei nicht vorhanden ist, wird sie erstellt. wenn es vorhanden ist und nicht schreibgeschützt ist, werden die Inhalte ersetzt.

Standardmäßig wird allen Benutzern vollständiger Lese-/Schreibzugriff auf neue Dateien gewährt. Die Datei wird mit Lese-/Schreibzugriff geöffnet und muss geschlossen werden, bevor sie von einer anderen Anwendung geöffnet werden kann.

Eine Liste der allgemeinen E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.