Compartir a través de


Input (Función)

Actualización: noviembre 2007

Lee datos de un archivo secuencial abierto y los asigna a variables.

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

Parámetros

  • FileNumber
    Requerido. Cualquier número de archivo válido.

  • Value
    Requerido. Variable a la que se le asignan los valores leídos del archivo (no puede ser ni una matriz ni una variable de objeto).

Excepciones

Tipo de excepción

Número de error

Condición

IOException

52

FileNumber no existe.

IOException

54

El modo de archivo no es válido.

Consulte la columna "Número de error" si está actualizando aplicaciones de Visual Basic 6.0 que utilizan el control de errores no estructurado. (Se puede comparar el número de error con respecto a Number (Propiedad, objeto Err)). Sin embargo, siempre que sea posible, se debe considerar la sustitución de dicho control de errores por Información general sobre el control estructurado de excepciones de Visual Basic.

Comentarios

La función Input se suministra a efectos de compatibilidad con versiones anteriores y puede tener un impacto en el rendimiento. En el caso de aplicaciones no heredadas, el objeto My.Computer.FileSystem proporciona un rendimiento superior. Para obtener más información, vea Acceso a archivos con Visual Basic.

Los datos leídos con Input se escriben normalmente en un archivo con Write. Utilice esta función sólo con archivos abiertos en modo Input o Binary.

Nota de seguridad:

Cuando se lee de archivos, no deben tomarse decisiones acerca del contenido del archivo basándose en la extensión del nombre de archivo. Por ejemplo, un archivo denominado Form1.vb puede no ser un archivo de código fuente de Visual Basic.

Una vez leídos, las cadenas estándar y los datos numéricos se asignan sin modificaciones a las variables. La siguiente tabla muestra el tratamiento que reciben otros tipos de datos de entrada.

Datos

Valor asignado a la variable

Coma o línea en blanco de delimitación

Vacío

#NULL#

DBNull

#TRUE# o #FALSE#

True o False

#yyyy-mm-ddhh:mm:ss#

El día o la hora representados por la expresión

#ERROR errornumber#

errornumber (la variable es un objeto etiquetado como error)

Si se llega al final del archivo mientras se está introduciendo un elemento de datos, la entrada se dará por terminada y se producirá un error.

Nota:

La función Input no se localiza. Por ejemplo, en la versión de alemán, si se escribe 3,14159, sólo se devuelve 3, ya que la coma se trata como separador de variables en lugar de separación decimal.

Nota de seguridad:

La lectura de un archivo con la función Input requiere acceso de tipo Read desde la enumeración FileIOPermissionAccess. Para obtener más información, vea FileIOPermissionAccess (Enumeración).

Ejemplo

En este ejemplo se utiliza la función Input para leer datos de un archivo en dos variables. En este ejemplo se supone que TestFile es un archivo con unas líneas de datos escritas en él mediante el uso de la función Write; cada línea contiene una cadena entrecomillada y un número separados por una coma, por ejemplo ("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)

Notas para desarrolladores de dispositivos inteligentes

Esta función no es compatible.

Requisitos

Espacio de nombres:Microsoft.VisualBasic

**Módulo:**FileSystem

**Ensamblado:**Visual Basic Runtime Library (en Microsoft.VisualBasic.dll)

Vea también

Tareas

Cómo: Escribir texto en archivos en Visual Basic

Cómo: Escribir texto en archivos con un objeto StreamWriter en Visual Basic

Referencia

InputString (Función)

FileOpen (Función)

Print, PrintLine (Funciones)

Write, WriteLine (Funciones)

Otros recursos

Acceso a archivos con Visual Basic