FileSystem.WriteAllBytes(String, Byte[], Boolean) Methode
Definition
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:
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 -> unitPublic 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 |
