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 |
|---|---|---|
FileNumber no existe. |
||
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.
.gif "Nota de seguridad") 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.
.gif "Nota") 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