My.Computer.FileSystem.WriteAllBytes-Methode

Aktualisiert: November 2007

Schreibt Daten in eine Binärdatei.

' Usage
My.Computer.FileSystem.WriteAllBytes(file ,data ,append)
' Declaration
Public Sub WriteAllBytes( _
   ByVal file As String, _
   ByVal data As Byte(), _
   ByVal append As Boolean _
)

Parameter

• file
  String. Pfad und Name der Datei, in die geschrieben werden soll. Erforderlich.

• data
  Byte. Daten, die in die Datei geschrieben werden sollen. Erforderlich.

• append
  Boolean. Ob Daten an vorhandene Daten angefügt oder ob vorhandene Daten überschrieben werden sollen. Der Standardwert ist False. Erforderlich.

Ausnahmen

Die folgenden Bedingungen können einen Ausnahmefehler verursachen:

• Der Pfad ist aus einem der folgenden Gründe ungültig: Es handelt sich um eine Zeichenfolge der Länge 0 (null), der Pfad enthält nur Leerzeichen, er enthält ungültige Zeichen, oder es handelt sich um einen Gerätepfad (beginnt mit \\.\) (ArgumentException).

• Der Pfad ist nicht gültig, da er Nothing ist oder mit einem umgekehrten Schrägstrich (\) endet (ArgumentNullException).

• Der file-Parameter zeigt auf einen Pfad, der nicht vorhanden ist (FileNotFoundException oder DirectoryNotFoundException).

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

• Der Pfad überschreitet die im System definierte maximale Länge (PathTooLongException).

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

• Der Benutzer verfügt nicht über die erforderlichen Berechtigungen zum Anzeigen des Pfads (SecurityException).

Hinweise

Wenn der append-Parameter True ist, werden die Daten an die Datei angefügt. Andernfalls werden die Daten in der Datei überschrieben.

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

Hinweis:

Mit der WriteAllBytes-Methode wird eine Datei geöffnet, in die Datei geschrieben und die Datei anschließend geschlossen. Code, der die WriteAllBytes-Methode verwendet, ist einfacher als Code, der ein BinaryWriter-Objekt verwendet. Wenn Sie jedoch mithilfe einer Schleife Daten zu einer Datei hinzufügen, bietet ein BinaryWriter-Objekt die höhere Leistung, da die Datei nur einmal geöffnet und geschlossen werden muss.

Aufgaben

Die folgende Tabelle enthält ein Beispiel für eine Aufgabe mit der My.Computer.FileSystem.WriteAllBytes-Methode.

Zweck	Weitere Informationen finden Sie unter
Schreiben in eine Binärdatei	Gewusst wie: Schreiben in Binärdateien in Visual Basic

Beispiel

In diesem Beispiel wird das Datenarray CustomerData an die Datei CollectedData angehängt.

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

Anforderungen

Namespace:Microsoft.VisualBasic.MyServices

Klasse:FileSystemProxy (ermöglicht den Zugriff auf FileSystem)

Assembly: Visual Basic-Laufzeitbibliothek (in Microsoft.VisualBasic.dll)

Verfügbarkeit nach Projekttyp

Projekttyp	Verfügbar
Windows-Anwendung	Ja
Klassenbibliothek	Ja
Konsolenanwendung	Ja
Windows-Steuerelementbibliothek	Ja
Web-Steuerelementbibliothek	Ja
Windows-Dienst	Ja
Website	Ja

Berechtigungen

Die folgende Berechtigung ist möglicherweise erforderlich.

Berechtigung	Beschreibung
FileIOPermission	Steuert die Fähigkeit, auf Dateien und Ordner zuzugreifen. Zugeordnete Enumeration: Unrestricted.

Weitere Informationen finden Sie unter Codezugriffssicherheit und unter Anfordern von Berechtigungen.

Siehe auch

Aufgaben

Gewusst wie: Schreiben in Binärdateien in Visual Basic

Referenz

My.Computer.FileSystem-Objekt

WriteAllBytes

Weitere Ressourcen

Schreiben in Dateien in Visual Basic