Input-Funktion

Aktualisiert: November 2007

Liest Daten aus einer geöffneten sequenziellen Datei und weist sie Variablen zu.

Public Sub Input( _
   FileNumber As Integer, _
   ByRef Value As Object _
)

Parameter

  • FileNumber
    Erforderlich. Beliebige gültige Dateinummer.

  • Value
    Erforderlich. Variable, der die aus der Datei gelesenen Werte zugewiesen werden. Sie darf keine Array- oder Objektvariable sein.

Ausnahmen

Ausnahmetyp

Fehlernummer

Bedingung

IOException

52

FileNumber ist nicht vorhanden.

IOException

54

Dateimodus ist ungültig.

Beachten Sie die Spalte "Fehlernummer", wenn Sie Visual Basic 6.0-Anwendungen aktualisieren, die eine unstrukturierte Fehlerbehandlung verwenden. (Sie können die Fehlernummer mit der Number-Eigenschaft (Err-Objekt) vergleichen.) Wenn möglich, sollten Sie jedoch erwägen, eine solche Fehlersteuerung durch eine Übersicht über die strukturierte Ausnahmebehandlung für Visual Basic zu ersetzen.

Hinweise

Die Input-Funktion wird für die Abwärtskompatibilität bereitgestellt und hat möglicherweise Auswirkungen auf die Leistung. Wenn es sich nicht um Legacyanwendungen handelt, bietet das My.Computer.FileSystem-Objekt eine bessere Leistung. Weitere Informationen finden Sie unter Dateizugriff mit Visual Basic.

Daten, die mit Input gelesen werden, werden normalerweise mit Write in eine Datei geschrieben. Verwenden Sie diese Funktion nur für Dateien, die im Modus Input oder Binary geöffnet wurden.

Sicherheitshinweis:

Treffen Sie beim Lesen von Daten aus Dateien Entscheidungen über den Dateiinhalt nicht auf der Grundlage der Dateierweiterung. Es kann z. B. sein, dass eine Datei mit dem Namen Form1.vb keine Visual Basic-Quelldatei ist.

Beim Lesen erfolgt die Zuweisung von normalen Zeichenfolgen oder numerischen Daten zu Variablen ohne jegliche Umwandlung. Die folgende Tabelle veranschaulicht, wie Eingabedaten behandelt werden.

Daten

Der Variablen zugewiesener Wert

Trennendes Komma oder leere Zeile

Leer

#NULL#

DBNull

#TRUE# oder #FALSE#

True oder False

#yyyy-mm-ddhh:mm:ss#

Datums- und/oder Zeitangabe, die durch den Ausdruck dargestellt wird

#FEHLER errornumber#

errornumber (Variable ist ein als Fehler markiertes Objekt)

Wird während der Eingabe eines Datenelements das Ende der Datei erreicht, so wird die Eingabe abgebrochen, und es tritt ein Fehler auf.

Hinweis:

Die Input-Funktion ist nicht lokalisiert. Wenn Sie in der deutschen Version z. B. 3,14159 eingeben, wird nur 3 zurückgegeben, denn das Komma wird als Variablentrennzeichen und nicht als Dezimalkomma behandelt.

Sicherheitshinweis:

Das Lesen einer Datei mit der Input-Funktion erfordert Read-Zugriff für die FileIOPermissionAccess-Enumeration. Weitere Informationen finden Sie unter FileIOPermissionAccess-Enumeration.

Beispiel

In diesem Beispiel werden mit der Input-Funktion Daten aus einer Datei in zwei Variablen eingelesen. In diesem Beispiel ist TestFile eine Datei, in die mit der Write-Funktion einige Zeilen mit Daten geschrieben wurden. Jede Zeile enthält eine Zeichenfolge in Anführungszeichen und eine davon durch ein Komma getrennte Zahl, zum Beispiel ("Hallo", 234).

FileOpen(1, "TESTFILE", OpenMode.Output)
Write(1, "hello")
Write(1, 14)
FileClose(1)
Dim s As String = "teststring"
Dim i As Integer 
FileOpen(1, "TESTFILE", OpenMode.Input)
Input(1, s)
MsgBox(s)
Input(1, i)
MsgBox(i)
FileClose(1)

Hinweise für Entwickler intelligenter Geräte

Diese Funktion wird nicht unterstützt.

Anforderungen

Namespace:Microsoft.VisualBasic

**Modul:**FileSystem

**Assembly:**Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Siehe auch

Aufgaben

Gewusst wie: Schreiben von Text in Dateien in Visual Basic

Gewusst wie: Schreiben von Text in Dateien mit einem Streamwriter in Visual Basic

Referenz

InputString-Funktion

FileOpen-Funktion

Die Funktionen "Print" und "PrintLine"

Die Funktionen "Write" und "WriteLine"

Weitere Ressourcen

Dateizugriff mit Visual Basic