My.Computer.FileSystem.OpenTextFieldParser (Método)

Actualización: noviembre 2007

El método OpenTextFieldParser permite crear un objeto TextFieldParser (Objeto), con el que se consigue un procedimiento sencillo y eficaz para analizar archivos de texto estructurados, como, por ejemplo, registros. El objeto TextFieldParser puede utilizarse para leer archivos de ancho fijo y delimitado.

' Usage
Dim value As TextFieldParser = My.Computer.FileSystem.OpenTextFieldParser(file)
Dim value As TextFieldParser = My.Computer.FileSystem.OpenTextFieldParser(file ,delimiters)
Dim value As TextFieldParser = My.Computer.FileSystem.OpenTextFieldParser(file ,fieldWidths)
' Declaration
Public Function OpenTextFieldParser( _
   ByVal file As String _
) As TextFieldParser
' -or-
Public Function OpenTextFieldParser( _
   ByVal file As String, _
   ByVal delimiters As String() _
) As TextFieldParser
' -or-
Public Function OpenTextFieldParser( _
   ByVal file As String, _
   ByVal fieldWidths As Integer() _
) As TextFieldParser

Parámetros

• file
  String. Archivo que se va a abrir con TextFieldParser. Obligatorio.

• delimiters
  String(). Delimitadores para los campos. Obligatorio.

• fieldWidths
  Integer(). Ancho de los campos. Obligatorio.

Valor devuelto

TextFieldParser

Excepciones

Las condiciones siguientes pueden producir una excepción:

• La ruta de acceso no es válida por una de las razones siguientes: es una cadena de longitud cero; sólo contiene un espacio en blanco; contiene caracteres no válidos; o es una ruta de acceso de dispositivo (empieza por \\.\) (ArgumentException).

• El nombre de archivo finaliza con una barra diagonal (ArgumentException).

• La ruta de acceso no es válida porque es Nothing (ArgumentNullException).

• El archivo especificado no existe (FileNotFoundException).

• El archivo especificado está en uso (IOException).

• La ruta de acceso supera la longitud máxima definida por el sistema (PathTooLongException).

• Un nombre de archivo o de directorio de la ruta de acceso contiene un signo de dos puntos (:) o tiene un formato no válido (NotSupportedException).

• El usuario no tiene los permisos necesarios para ver la ruta de acceso (SecurityException).

• Una fila no se puede analizar utilizando el formato especificado (MalformedLineException). El mensaje de excepción especifica la línea que produce la excepción, mientras que el texto contenido en la línea se asigna a TextFieldParser.ErrorLine (Propiedad).

• El usuario no tiene permisos suficientes para el acceso al archivo (UnauthorizedAccessException).

Tareas

En la tabla siguiente se muestran ejemplos de tareas en las que interviene el método My.Computer.FileSystem.OpenTextFieldParser.

Ejemplo

En este ejemplo se abre TextFieldParserreader, que se utiliza para leer C:\TestFolder1\Test1.txt.

Dim reader As Microsoft.VisualBasic.FileIO.TextFieldParser
reader = My.Computer.FileSystem.OpenTextFieldParser _
("C:\TestFolder1\test1.txt")
reader.TextFieldType = Microsoft.VisualBasic.FileIO.FieldType.Delimited
reader.delimiters = New String() {","}
Dim currentRow As String()
While Not reader.EndOfData
    Try
        currentRow = reader.ReadFields()
        Dim currentField As String
        For Each currentField In currentRow
            MsgBox(currentField)
        Next
    Catch ex As Microsoft.VisualBasic.FileIO.MalformedLineException
        MsgBox("Line " & ex.Message & _
        "is not valid and will be skipped.")
    End Try
End While

Requisitos

Espacio de nombres:Microsoft.VisualBasic.MyServices

Clase:FileSystemProxy (proporciona acceso a FileSystem)

Ensamblado: biblioteca en tiempo de ejecución de Visual Basic (en Microsoft.VisualBasic.dll)

Disponibilidad por tipo de proyecto

Permisos

Los permisos siguientes pueden ser necesarios:

Para obtener más información, vea Seguridad de acceso a código y Solicitar permisos.

Vea también

Tareas

Cómo: Leer archivos de texto en Visual Basic

Cómo: Leer archivos de texto delimitado por comas en Visual Basic

Cómo: Leer archivos de texto con varios formatos en Visual Basic

Conceptos

Analizar archivos de texto con el objeto TextFieldParser

Referencia

My.Computer.FileSystem (Objeto)

TextFieldParser (Objeto)

OpenTextFieldParser

Otros recursos

Leer archivos en Visual Basic