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

Definition

Namespace:

Microsoft.VisualBasic.FileIO

Assembly:

Microsoft.VisualBasic.Core.dll

Quelle:

FileSystem.vb

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

ArgumentException

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.

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 im System definierte maximale Länge.

NotSupportedException

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

OutOfMemoryException

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

SecurityException

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