File.WriteAllBytes(String, Byte[]) Methode

Definition

Erstellt eine neue Datei, schreibt das angegebene Bytearray in die Datei und schließt die Datei dann.Creates a new file, writes the specified byte array to the file, and then closes the file. Ist die Zieldatei bereits vorhanden, wird sie überschrieben.If the target file already exists, it is overwritten.

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.The file to write to.

bytes
Byte[]

Die Bytes, die in die Datei geschrieben werden sollen.The bytes to write to the file.

Ausnahmen

path ist eine leere Zeichenfolge, enthält nur Leerzeichen oder mindestens ein ungültiges Zeichen gemäß der Definition von InvalidPathChars.path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

path ist gleich null, oder das Bytearray ist leer.path is null or the byte array is empty.

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.The specified path, file name, or both exceed the system-defined maximum length.

Der angegebene Pfad ist ungültig (er befindet sich z. B. auf einem nicht zugeordneten Laufwerk).The specified path is invalid (for example, it is on an unmapped drive).

Beim Öffnen der Datei ist ein E/A-Fehler aufgetreten.An I/O error occurred while opening the file.

path hat eine schreibgeschützte Datei angegeben.path specified a file that is read-only.

- oder --or- path hat eine schreibgeschützte Datei angegeben.path specified a file that is hidden.

- oder --or- Dieser Vorgang wird von der aktuellen Plattform nicht unterstützt.This operation is not supported on the current platform.

- oder --or- path hat ein Verzeichnis angegeben.path specified a directory.

- oder --or- Der Aufrufer verfügt nicht über die erforderliche Berechtigung.The caller does not have the required permission.

path weist ein ungültiges Format auf.path is in an invalid format.

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.The caller does not have the required permission.

Hinweise

Bei einem Bytearray und einem Dateipfad öffnet diese Methode die angegebene Datei, schreibt den Inhalt des Bytearrays in die Datei und schließt die Datei dann.Given a byte array and a file path, this method opens the specified file, writes the contents of the byte array to the file, and then closes the file.

Sicherheit

FileIOPermission
für den Zugriff zum Schreiben in eine Datei oder ein Verzeichnis.for access to write to a file or directory. Zugehörige Enumeration: WriteAssociated enumeration: Write

Gilt für: