File.WriteAllBytes Methode
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
| 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. |
- 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[] -> unitPublic 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:
.NET 10 und andere Versionen
| Produkt | Versionen |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10 |
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.3, 1.4, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
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> -> unitPublic 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:
.NET 10 und .NET 9
| Produkt | Versionen |
|---|---|
| .NET | 9, 10 |
Feedback zu .NET
.NET ist ein Open Source-Projekt. Wählen Sie einen Link aus, um Feedback zu geben: