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

Definition

Namespace:
Microsoft.VisualBasic.FileIO
Assembly:
Microsoft.VisualBasic.dll

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

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

data
Byte[]

Daten, die in die Datei geschrieben werden sollen.

append
Boolean

True an den Dateiinhalt anzufügen; False um den Dateiinhalt zu überschreiben. Der Standardwert ist False.

Ausnahmen

ArgumentException

Der Pfad ist aus einem der folgenden Gründe ungültig: Es handelt sich um eine leere Zeichenfolge; es enthält nur Leerzeichen; enthält ungültige Zeichen; oder es handelt sich um einen Gerätepfad (beginnt mit \\.\); sie endet mit einem nachgestellten Schrägstrich.

ArgumentNullException

file ist Nothing.

FileNotFoundException

Die Datei ist nicht vorhanden.

IOException

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

PathTooLongException

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

NotSupportedException

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

OutOfMemoryException

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

SecurityException

Der Benutzer verfügt nicht über erforderliche 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.

Note

Die WriteAllBytes Methode öffnet eine Datei, schreibt sie, und schließt sie. Code, der die WriteAllBytes Methode verwendet, ist einfacher als Code, der ein BinaryWriter Objekt verwendet. Wenn Sie einer Datei jedoch Daten 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.

To Siehe
Schreiben in eine Binärdatei How to: Write to Binary Files in Visual Basic

Gilt für: