File.Create Methode

Definition

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

Überlädt

Name Beschreibung
Create(String)

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

Create(String, Int32)

Erstellt oder abgeschnitten und überschreibt eine Datei im angegebenen Pfad, die eine Puffergröße angibt.

Create(String, Int32, FileOptions)

Erstellt oder überschreibt eine Datei im angegebenen Pfad und gibt eine Puffergröße und Optionen an, die beschreiben, wie die Datei erstellt oder überschrieben wird.

Create(String, Int32, FileOptions, FileSecurity)

Erstellt oder überschreibt eine Datei im angegebenen Pfad, wobei eine Puffergröße, Optionen, die beschreiben, wie die Datei erstellt oder überschrieben wird, und ein Wert, der die Zugriffssteuerung und Überwachungssicherheit für die Datei bestimmt.

Create(String)

Quelle:
File.cs
Quelle:
File.cs
Quelle:
File.cs
Quelle:
File.cs
Quelle:
File.cs

Erstellt oder abgeschnitten 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

A FileStream that provides read/write access to the file specified in path.

Ausnahmen

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

-oder-

path eine Datei angegeben, die schreibgeschützt ist.

-oder-

path eine ausgeblendete Datei angegeben.

.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.

path ist null.

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

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

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

path ist in einem ungültigen Format vorhanden.

Beispiele

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

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 einen Standardwert FileShare von None; kein anderer Prozess oder Code kann auf die erstellte Datei zugreifen, bis das ursprüngliche Dateihandle geschlossen ist.

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

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 sie vorhanden ist und nicht schreibgeschützt ist, werden die Inhalte gelöscht und überschrieben.

Standardmäßig wird allen Benutzern der vollständige 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 allgemeiner E/A-Aufgaben finden Sie unter "Allgemeine E/A-Aufgaben".

Weitere Informationen

Gilt für:

Create(String, Int32)

Quelle:
File.cs
Quelle:
File.cs
Quelle:
File.cs
Quelle:
File.cs
Quelle:
File.cs

Erstellt oder abgeschnitten und überschreibt eine Datei im angegebenen Pfad, die eine Puffergröße angibt.

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 Bytes, die für Lese- und Schreibvorgänge in die Datei gepuffert wurden.

Gibt zurück

A FileStream mit der angegebenen Puffergröße, die Lese-/Schreibzugriff auf die in pathder Datei angegebene Datei bietet.

Ausnahmen

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

-oder-

path eine Datei angegeben, die schreibgeschützt ist.

-oder-

path eine ausgeblendete Datei angegeben.

.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.

path ist null.

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

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

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

path ist in einem ungültigen Format vorhanden.

Beispiele

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

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 einen Standardwert FileShare von None; kein anderer Prozess oder Code kann auf die erstellte Datei zugreifen, bis das ursprüngliche Dateihandle geschlossen 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.

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

Standardmäßig wird allen Benutzern der vollständige 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 allgemeiner E/A-Aufgaben finden Sie unter "Allgemeine E/A-Aufgaben".

Weitere Informationen

Gilt für:

Create(String, Int32, FileOptions)

Quelle:
File.cs
Quelle:
File.cs
Quelle:
File.cs
Quelle:
File.cs
Quelle:
File.cs

Erstellt oder überschreibt eine Datei im angegebenen Pfad und gibt eine Puffergröße und Optionen an, die beschreiben, wie die Datei erstellt oder überschrieben wird.

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 Bytes, die für Lese- und Schreibvorgänge in die Datei gepuffert wurden.

options
FileOptions

Einer der FileOptions Werte, der beschreibt, wie die Datei erstellt oder überschrieben wird.

Gibt zurück

Eine neue Datei mit der angegebenen Puffergröße.

Ausnahmen

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

-oder-

path eine Datei angegeben, die schreibgeschützt ist.

-oder-

path eine ausgeblendete Datei angegeben.

.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.

path ist null.

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

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

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

path ist in einem ungültigen Format vorhanden.

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 sie vorhanden ist und nicht schreibgeschützt ist, werden die Inhalte ersetzt.

Standardmäßig wird allen Benutzern der vollständige 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 allgemeiner E/A-Aufgaben finden Sie unter "Allgemeine E/A-Aufgaben".

Gilt für:

Create(String, Int32, FileOptions, FileSecurity)

Erstellt oder überschreibt eine Datei im angegebenen Pfad, wobei eine Puffergröße, Optionen, die beschreiben, wie die Datei erstellt oder überschrieben wird, und ein Wert, der die Zugriffssteuerung und Überwachungssicherheit für die Datei bestimmt.

public:
 static System::IO::FileStream ^ Create(System::String ^ path, int bufferSize, System::IO::FileOptions options, System::Security::AccessControl::FileSecurity ^ fileSecurity);
public static System.IO.FileStream Create(string path, int bufferSize, System.IO.FileOptions options, System.Security.AccessControl.FileSecurity fileSecurity);
static member Create : string * int * System.IO.FileOptions * System.Security.AccessControl.FileSecurity -> System.IO.FileStream
Public Shared Function Create (path As String, bufferSize As Integer, options As FileOptions, fileSecurity As FileSecurity) As FileStream

Parameter

path
String

Der Pfad und der Name der zu erstellenden Datei.

bufferSize
Int32

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

options
FileOptions

Einer der FileOptions Werte, der beschreibt, wie die Datei erstellt oder überschrieben wird.

fileSecurity
FileSecurity

Ein FileSecurity Objekt, das die Zugriffssteuerung und die Überwachungssicherheit für die Datei bestimmt.

Gibt zurück

Eine neue Datei mit der angegebenen Puffergröße, Dateioptionen und Dateisicherheit.

Ausnahmen

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

-oder-

path eine Datei angegeben, die schreibgeschützt ist.

-oder-

path eine ausgeblendete Datei angegeben.

.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.

path ist null.

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

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

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

path ist in einem ungültigen Format vorhanden.

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 sie vorhanden ist und nicht schreibgeschützt ist, werden die Inhalte ersetzt.

Standardmäßig wird allen Benutzern der vollständige 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 allgemeiner E/A-Aufgaben finden Sie unter "Allgemeine E/A-Aufgaben".

Important

Diese Methode wurde in folgender Form zu .NET Core 3.1 portiert: Create(FileInfo, FileMode, FileSystemRights, FileShare, Int32, FileOptions, FileSecurity).

Gilt für: