Funzione InputString

Aggiornamento: novembre 2007

Restituisce il valore String contenente i caratteri di un file aperto in modalità Input o Binary.

Nelle operazioni di I/O dei file la funzionalità My offre un più elevato livello di produttività e prestazioni rispetto a InputString. Per ulteriori informazioni, vedere Oggetto My.Computer.FileSystem.

InputString(_
   ByVal FileNumber As Integer, _
   ByVal CharCount As Integer _
) As String

Parametri

• FileNumber
  Obbligatorio. Qualsiasi numero di file valido.

• CharCount
  Obbligatorio. Qualsiasi espressione numerica valida nella quale è specificato il numero di caratteri da leggere.

Eccezioni

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 InputString 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 mediante la funzione InputString vengono generalmente scritti in un file con Print o FilePut. Utilizzare questa funzione solo con i file aperti in modalità Input o Binary.

A differenza della funzione Input, la funzione InputString restituisce tutti i caratteri letti, incluse virgole, ritorni a capo, caratteri di avanzamento riga, virgolette e spazi iniziali.

In caso di file aperti per l'accesso Binary, verrà generato un errore se si tenta di leggere il file utilizzando la funzione InputString finché EOF non restituisce True. Utilizzare le funzioni LOF e Loc anziché EOF quando si leggono i file binari mediante InputString oppure FileGet quando si utilizza la funzione EOF.

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.

Esempio

In questo esempio la funzione InputString viene utilizzata per leggere un file un carattere alla volta e scrivere ogni carattere nella finestra Output. Nell'esempio si presuppone che MyFile sia un file di testo nel quale sono incluse alcune righe di dati di esempio.

Dim oneChar As String
' Open file.
FileOpen(1,  "MYFILE.TXT", OpenMode.Input)
' Loop until end of file.
While Not EOF(1)
' Get one character.
oneChar = (InputString(1, 1))
' Print to the output window.
System.Console.Out.WriteLine(oneChar)
End While
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 con uno StreamWriter in Visual Basic

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

Riferimenti

Funzione Input

Altre risorse

Accesso ai file con Visual Basic