InputString (Función)

Actualización: noviembre 2007

Devuelve un valor String que contiene caracteres de un archivo abierto en modo Input o Binary.

La característica My proporciona mayor productividad y rendimiento en las operaciones de E/S del archivo que si se utiliza InputString. Para obtener más información, vea My.Computer.FileSystem (Objeto).

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

Parámetros

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

• CharCount
  Requerido. Cualquier expresión numérica válida que especifique el número de caracteres que se han de leer.

Excepciones

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 InputString 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 la función InputString normalmente se escriben en un archivo con Print o FilePut. Utilice esta función sólo con archivos abiertos en modo Input o Binary.

A diferencia de la función Input, la función InputString devuelve todos los caracteres que lee, incluidos comas, retornos de carro, avances de línea, comillas y espacios iniciales.

En los archivos abiertos para acceso Binary, se genera un error al intentar leer el archivo mediante la función InputString hasta que EOF devuelve True. Utilice las funciones LOF y Loc en lugar de EOF cuando se lean archivos binarios con InputString o utilice FileGet cuando se utilice la función EOF.

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.

Ejemplo

En este ejemplo se utiliza la función InputString para leer los caracteres de un archivo de uno en uno e imprimirlos en la ventana Output. En este ejemplo se supone que MyFile es un archivo de texto con unas pocas líneas de datos de ejemplo.

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)

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

Input (Función)

Otros recursos

Acceso a archivos con Visual Basic