LineInput (Función)

Actualización: noviembre 2007

Lee una sola línea de un archivo secuencial abierto y la asigna a una variable String.

Public Function LineInput(ByVal FileNumber As Integer) As String

Parámetros

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

Excepciones

Tipo de excepción

Número de error

Condición

EndOfStreamException

62

Se ha llegado al final del archivo.

IOException

52

FileNumber no existe.

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 LineInput 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 LineInput se escriben normalmente en un archivo con Print.

Nota de seguridad:

Cuando se lee de archivos, no deben tomarse decisiones acerca del contenido de un 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.

La función LineInput lee un carácter a la vez de un archivo hasta que encuentra un retorno de carro (Chr(13)) o una secuencia de retorno de carro y avance de línea (Chr(13) + Chr(10)). En vez de anexarse a las cadenas de caracteres, las secuencias retorno de carro-avance de línea se omiten.

Nota de seguridad:

La lectura de un archivo con la función LineInput requiere acceso de tipo Read desde la enumeración FileIOPermissionAccess.

Ejemplo

En este ejemplo se utiliza la función LineInput para leer una línea de un archivo secuencial y asignársela a una variable. En este ejemplo se supone que TestFile es un archivo de texto con unas pocas líneas de datos de ejemplo.

Dim TextLine As String
' Open file.
FileOpen(1, "TESTFILE", OpenMode.Input)
' Loop until end of file.
While Not EOF(1)
   ' Read line into variable.
   TextLine = LineInput(1)
   ' Print to the console.
   WriteLine(1, TextLine)
End While
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 con un objeto StreamWriter en Visual Basic

Cómo: Escribir texto en archivos en Visual Basic

Referencia

Chr, ChrW (Funciones)

Input (Función)

Otros recursos

Acceso a archivos con Visual Basic