Funzione Input

Aggiornamento: novembre 2007

Legge i dati da un file aperto in modalità Sequential e li assegna alle variabili.

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

Parametri

  • FileNumber
    Obbligatorio. Qualsiasi numero di file valido.

  • Value
    Obbligatorio. Variabile assegnata ai valori letti dal file, che non può essere una matrice o una variabile oggetto.

Eccezioni

Tipo di eccezione

Numero di errore

Condizione

IOException

52

FileNumber non esiste.

IOException

54

Modalità di accesso ai file non valida.

Se si esegue l'aggiornamento delle applicazioni Visual Basic 6.0 che utilizzano la gestione degli errori non strutturata, vedere la colonna "Numero di errore". È possibile confrontare il numero di errore con la Proprietà Number (oggetto Err). Se possibile, tuttavia, si consiglia di sostituire il controllo dell'errore con la procedura illustrata nella sezione Cenni preliminari sulla gestione strutturata delle eccezioni per Visual Basic.

Note

La funzione Input viene fornita a scopo di compatibilità con le versioni precedenti e può influire sulle prestazioni. Per le applicazioni non preesistenti, l'oggetto My.Computer.FileSystem garantisce prestazioni migliori. Per ulteriori informazioni, vedere Accesso ai file con Visual Basic.

I dati letti tramite Input vengono in genere scritti in un file con Write. Utilizzare questa funzione solo con i file aperti in modalità Input o Binary.

Nota sulla sicurezza:

Quando si effettua la lettura da file, non prendere decisioni sul contenuto del file in base alla relativa estensione. È infatti possibile che un file denominato, ad esempio, Form1.vb non sia un file di origine di Visual Basic.

Dopo la lettura, le stringhe standard o i dati numerici vengono assegnati alle variabili nella forma originale. Nella tabella seguente vengono descritte le assegnazioni per altri dati di input.

Dati

Valore assegnato alla variabile

Virgola di separazione o riga vuota

Vuoto

#NULL#

DBNull

#TRUE# o #FALSE#

True oppure False

#yyyy-mm-ddhh:mm:ss#

La data e/o l'ora rappresentate dall'espressione

#ERROR errornumber#

errornumber (la variabile è un oggetto corrispondente a un errore)

Se viene raggiunta la fine del file durante l'input dei dati, l'input verrà interrotto e verrà generato un errore.

Nota:

La funzione Input non è localizzata. Nella versione in lingua tedesca, ad esempio, se si immette come input 3,14159, verrà restituito solo 3 poiché la virgola viene considerata come separatore di variabili, anziché separatore decimale.

Nota sulla sicurezza:

La lettura da un file con la funzione Input richiede l'accesso Read dall'enumerazione FileIOPermissionAccess. Per ulteriori informazioni, vedere Enumerazione FileIOPermissionAccess.

Esempio

Nell'esempio riportato di seguito la funzione Input viene utilizzata per leggere dati da un file in due variabili. Nell'esempio si presuppone che TestFile sia un file con poche righe di dati scritti mediante la funzione Write e con ogni riga contenente una stringa tra virgolette e un numero separato da una virgola, ad esempio "Hello", 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)

Note per gli sviluppatori di applicazioni per Smart Device

Questa funzione non è supportata.

Requisiti

Spazio dei nomi:Microsoft.VisualBasic

**Modulo:**FileSystem

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

Vedere anche

Attività

Procedura: scrivere testo all'interno di file in Visual Basic

Procedura: scrivere testo all'interno di file con uno StreamWriter in Visual Basic

Riferimenti

Funzione InputString

Funzione FileOpen

Funzioni Print e PrintLine

Funzioni Write e WriteLine

Altre risorse

Accesso ai file con Visual Basic