File.WriteAllBytes(String, Byte[]) Methode

Definition

Namespace:

System.IO

Assembly:

System.Runtime.dll

Quelle:

File.cs

Erstellt eine neue Datei, schreibt das angegebene Bytearray in die Datei und schließt die Datei dann. 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

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 mindestens ein ungültiges Zeichen. Sie können Abfragen für ungültige Zeichen mithilfe der GetInvalidPathChars()-Methode ausführen.

ArgumentNullException

path ist gleich null, oder das Bytearray ist leer.

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

UnauthorizedAccessException

path hat eine schreibgeschützte Datei angegeben.

- oder -

path hat eine schreibgeschützte Datei angegeben.

- oder -

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

- oder -

path hat ein Verzeichnis angegeben.

- oder -

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

NotSupportedException

path weist ein ungültiges Format auf.

SecurityException

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

Hinweise

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