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

Referenz

Definition

Namespace:: Microsoft.VisualBasic.MyServices

Assembly:: Microsoft.VisualBasic.dll

Assembly:: Microsoft.VisualBasic.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Schreibt Daten in eine Binärdatei.

public:
 void WriteAllBytes(System::String ^ file, cli::array <System::Byte> ^ data, bool append);

public void WriteAllBytes (string file, byte[] data, bool append);

member this.WriteAllBytes : string * byte[] * bool -> unit

Public 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	Vorgehensweise: Schreiben in Binärdateien

Gilt für:

Freigeben über