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 |
---|---|---|
FileNumber ist nicht vorhanden. |
||
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
Die Funktionen "Print" und "PrintLine"
Die Funktionen "Write" und "WriteLine"