My.Computer.FileSystem.ReadAllBytes-Methode
Aktualisiert: November 2007
Gibt den Inhalt einer Datei als Bytearray zurück.
' Usage
Dim value As Byte() = My.Computer.FileSystem.ReadAllBytes(file)
' Declaration
Public Function ReadAllBytes( _
ByVal file As String _
) As Byte()
Parameter
- file
String. Die zu lesende Datei. Erforderlich.
Rückgabewert
Byte-Array mit dem Inhalt der Datei.
Ausnahmen
Die folgenden Bedingungen verursachen möglicherweise das Auslösen einer Ausnahme:
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 Dateiname endet mit einem nachgestellten Schrägstrich (ArgumentException).
Der Pfad ist ungültig, da er Nothing ist (ArgumentNullException).
Die Datei ist nicht vorhanden (FileNotFoundException).
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).
Es ist nicht genügend Arbeitsspeicher vorhanden, um die Zeichenfolge in den Puffer zu schreiben (OutOfMemoryException).
Der Benutzer verfügt nicht über die erforderlichen Berechtigungen zum Anzeigen des Pfads (SecurityException).
Hinweise
Die ReadAllBytes-Methode des My.Computer.FileSystem-Objekts ermöglicht das Lesen aus einer Binärdatei. Der Inhalt der Datei wird als Bytearray zurückgegeben.
Beurteilen Sie den Inhalt der Datei nicht anhand des Dateinamens. Bei der Datei Form1.vb handelt es sich zum Beispiel nicht unbedingt um eine Visual Basic-Quelldatei. Überprüfen Sie alle Eingaben, bevor Sie die Daten in der Anwendung verwenden.
Aufgaben
In der folgenden Tabelle werden Beispiele für Aufgaben mit der My.Computer.FileSystem.ReadAllBytes-Methode aufgeführt.
Zweck |
Weitere Informationen finden Sie unter |
|---|---|
Lesen aus einer Binärdatei |
Beispiel
In diesem Beispiel wird aus der Datei C:/Documents and Settings/selfportrait.jpg. gelesen.
My.Computer.FileSystem.ReadAllBytes _
("C:/Documents and Settings/selfportrait.jpg")
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 |
|---|---|
Steuert die Fähigkeit, auf Dateien und Ordner zuzugreifen. Zugeordnete Enumeration: Unrestricted. |
Weitere Informationen finden Sie unter Codezugriffssicherheit und unter Anfordern von Berechtigungen.