Share via


TextFieldParser (Objeto)

Actualización: noviembre 2007

Proporciona métodos y propiedades para analizar archivos de texto estructurados.

Public Class TextFieldParser

Excepciones

La condición siguiente puede provocar una excepción:

  • Un campo de texto no coincide con el formato especificado. Por ejemplo, en un archivo de ancho fijo, uno de los campos no coincide con el ancho especificado. (MalformedLineException).

Comentarios

El objeto TextFieldParser proporciona métodos y propiedades para analizar archivos de texto estructurados. Analizar un archivo de texto con TextFieldParser es similar a recorrer en iteración un archivo de texto, mientras que utilizar el método ReadFields para extraer campos de texto es similar a dividir las cadenas.

TextFieldParser puede analizar dos tipos de archivos: delimitados o de ancho fijo. Algunas propiedades, como Delimiters y HasFieldsEnclosedInQuotes, sólo cobran sentido cuando trabajan con archivos delimitados, mientras que la propiedad FieldWidths cobra sentido únicamente cuando trabaja con archivos de ancho fijo.

Tareas

En la tabla siguiente se muestran ejemplos de tareas que implican al objeto Microsoft.VisualBasic.FileIO.TextFieldParser.

Para

Vea

Leer un archivo de texto delimitado

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

Leer un archivo de texto de ancho fijo

Cómo: Leer archivos de texto de ancho fijo en Visual Basic

Leer un archivo de texto con varios formatos

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

Ejemplo

En este ejemplo se analiza un archivo de texto delimitado por tabulaciones, Bigfile.

Using MyReader As New Microsoft.VisualBasic.FileIO.TextFieldParser _
("c:\logs\bigfile")
    MyReader.TextFieldType = Microsoft.VisualBasic.FileIO.FieldType.Delimited
    MyReader.Delimiters = New String() {vbTab}
    Dim currentRow As String()
    'Loop through all of the fields in the file. 
    'If any lines are corrupt, report an error and continue parsing. 
    While Not MyReader.EndOfData
        Try
            currentRow = MyReader.ReadFields()
            ' Include code here to handle the row.
        Catch ex As Microsoft.VisualBasic.FileIO.MalformedLineException
            MsgBox("Line " & ex.Message & _
            " is invalid.  Skipping")
        End Try
    End While
End Using

Este ejemplo depende de la existencia de una función, processFields, que procesa los campos a medida que se leen.

Requisitos

Espacio de nombres:Microsoft.VisualBasic.FileIO

Clase:TextFieldParser

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

Vea también

Tareas

Solución de problemas de excepciones: Microsoft.VisualBasic.FileIO.TextFieldParser.MalformedLineException

Conceptos

Analizar archivos de texto con el objeto TextFieldParser

Referencia

TextFieldParser (Miembros del objeto)

TextFieldParser.CommentTokens (Propiedad)

TextFieldParser.Delimiters (Propiedad)

TextFieldParser.EndOfData (Propiedad)

TextFieldParser.ErrorLine (Propiedad)

TextFieldParser.ErrorLineNumber (Propiedad)

TextFieldParser.FieldWidths (Propiedad)

TextFieldParser.HasFieldsEnclosedInQuotes (Propiedad)

TextFieldParser.LineNumber (Propiedad)

TextFieldParser.TextFieldType (Propiedad)

TextFieldParser.TrimWhiteSpace (Propiedad)

TextFieldParser.Close (Método)

TextFieldParser.PeekChars (Método)

TextFieldParser.ReadFields (Método)

TextFieldParser.ReadLine (Método)

TextFieldParser.ReadToEnd (Método)

TextFieldParser.SetDelimiters (Método)

TextFieldParser.SetFieldWidths (Método)

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

Microsoft.VisualBasic.FileIO.TextFieldParser