Freigeben über


File.WriteAllBytes Methode

Definition

Überlädt

WriteAllBytes(String, Byte[])

Erstellt eine neue Datei, schreibt das angegebene Bytearray in die Datei und schließt dann die Datei. Wenn die Zieldatei bereits vorhanden ist, wird sie abgeschnitten und überschrieben.

WriteAllBytes(String, ReadOnlySpan<Byte>)

Erstellt eine neue Datei, schreibt das angegebene Bytearray in die Datei und schließt dann die Datei. Wenn die Zieldatei bereits vorhanden ist, wird sie abgeschnitten und überschrieben.

WriteAllBytes(String, Byte[])

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

Erstellt eine neue Datei, schreibt das angegebene Bytearray in die Datei und schließt dann die Datei. Wenn die Zieldatei bereits vorhanden ist, wird sie abgeschnitten und überschrieben.

public:
 static void WriteAllBytes(System::String ^ path, cli::array <System::Byte> ^ bytes);
public static void WriteAllBytes (string path, byte[] bytes);
static member WriteAllBytes : string * byte[] -> unit
Public Shared Sub WriteAllBytes (path As String, bytes As Byte())

Parameter

path
String

Die Datei, in die geschrieben werden soll.

bytes
Byte[]

Die Bytes, die in die Datei geschrieben werden sollen.

Ausnahmen

.NET Framework- und .NET Core-Versionen, die älter als 2.1 sind: path ist 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 oder das Bytearray leer ist.

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 Öffnen der Datei ist ein E/A-Fehler aufgetreten.

path eine Datei angegeben, die schreibgeschützt ist.

-oder-

path eine ausgeblendete Datei angegeben.

-oder-

Dieser Vorgang wird auf der aktuellen Plattform nicht unterstützt.

-oder-

path ein Verzeichnis angegeben.

-oder-

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

path weist ein ungültiges Format auf.

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

Hinweise

Angesichts eines Bytearrays und eines Dateipfads öffnet diese Methode die angegebene Datei, schreibt den Inhalt des Bytearrays in die Datei und schließt dann die Datei.

Gilt für:

WriteAllBytes(String, ReadOnlySpan<Byte>)

Erstellt eine neue Datei, schreibt das angegebene Bytearray in die Datei und schließt dann die Datei. Wenn die Zieldatei bereits vorhanden ist, wird sie abgeschnitten und überschrieben.

public:
 static void WriteAllBytes(System::String ^ path, ReadOnlySpan<System::Byte> bytes);
public static void WriteAllBytes (string path, ReadOnlySpan<byte> bytes);
static member WriteAllBytes : string * ReadOnlySpan<byte> -> unit
Public Shared Sub WriteAllBytes (path As String, bytes As ReadOnlySpan(Of Byte))

Parameter

path
String

Die Datei, in die geschrieben werden soll.

bytes
ReadOnlySpan<Byte>

Die Bytes, die in die Datei geschrieben werden sollen.

Ausnahmen

path ist null.

path ist leer.

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 Öffnen der Datei ist ein E/A-Fehler aufgetreten.

path eine Datei angegeben, die schreibgeschützt ist.

-oder-

path eine ausgeblendete Datei angegeben.

-oder-

path ein Verzeichnis angegeben.

-oder-

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

-oder-

Dieser Vorgang wird auf der aktuellen Plattform nicht unterstützt.

path weist ein ungültiges Format auf.

Gilt für: