Freigeben über


FileSystem.WriteAllBytes(String, Byte[], Boolean) Methode

Definition

Schreibt Daten in eine Binärdatei.

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

Parameter

file
String

Der Pfad und Name der Datei, in die geschrieben werden soll.

data
Byte[]

Die in die Datei zu schreibenden Daten.

append
Boolean

True, wenn Daten an den Inhalt der Datei angefügt werden sollen, False, wenn der Inhalt der Datei überschrieben werden soll. Der Standardwert ist False.

Ausnahmen

Der Pfad ist aus einem der folgenden Gründe ungültig: Er ist eine Zeichenfolge der Länge null; es enthält nur Leerzeichen; enthält ungültige Zeichen; oder es ist ein Gerätepfad (beginnt mit \\.\); sie endet mit einem nachfolgenden Schrägstrich.

file ist Nothing.

Die Datei ist nicht vorhanden.

Die Datei wird von einem anderen Prozess verwendet, oder ein E/A-Fehler tritt auf.

Der Pfad überschreitet die im System definierte maximale Länge.

Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) oder hat ein ungültiges Format.

Es ist nicht genügend Arbeitsspeicher vorhanden, um die Zeichenfolge in den Puffer zu schreiben.

Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads.

Beispiele

In diesem Beispiel wird das Datenarray CustomerData an die Datei CollectedDataangefügt.

My.Computer.FileSystem.WriteAllBytes(
  "C:\MyDocuments\CustomerData", CustomerData, True)

Hinweise

Wenn der angegebene Pfad mit Ausnahme des Dateinamens ungültig ist, wird eine DirectoryNotFoundException Ausnahme ausgelöst. Wenn der Pfad gültig ist, die Datei aber nicht vorhanden ist, wird die Datei erstellt.

Hinweis

Die WriteAllBytes -Methode öffnet eine Datei, schreibt in sie und schließt sie dann. Code, der die WriteAllBytes -Methode verwendet, ist einfacher als Code, der ein BinaryWriter -Objekt verwendet. Wenn Sie jedoch daten zu einer Datei mithilfe einer Schleife hinzufügen, kann ein BinaryWriter Objekt eine bessere Leistung bieten, da Sie die Datei nur einmal öffnen und schließen müssen.

In der folgenden Tabelle ist ein Beispiel für eine Aufgabe aufgeführt, die die My.Computer.FileSystem.WriteAllBytes -Methode umfasst.

Beschreibung Siehe
Schreiben in eine Binärdatei Gewusst wie: Schreiben in Binärdateien in Visual Basic

Gilt für: