Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase TextFieldParser

 

Publicado: noviembre de 2016

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

Espacio de nombres:   Microsoft.VisualBasic.FileIO
Ensamblado:  Microsoft.VisualBasic (en Microsoft.VisualBasic.dll)

System.Object
  Microsoft.VisualBasic.FileIO.TextFieldParser

public class TextFieldParser : IDisposable

NombreDescripción
System_CAPS_pubmethodTextFieldParser(Stream)

Inicializa una nueva instancia de la clase TextFieldParser.

System_CAPS_pubmethodTextFieldParser(Stream, Encoding)

Inicializa una nueva instancia de la clase TextFieldParser.

System_CAPS_pubmethodTextFieldParser(Stream, Encoding, Boolean)

Inicializa una nueva instancia de la clase TextFieldParser.

System_CAPS_pubmethodTextFieldParser(Stream, Encoding, Boolean, Boolean)

Inicializa una nueva instancia de la clase TextFieldParser.

System_CAPS_pubmethodTextFieldParser(String)

Inicializa una nueva instancia de la clase TextFieldParser.

System_CAPS_pubmethodTextFieldParser(String, Encoding)

Inicializa una nueva instancia de la clase TextFieldParser.

System_CAPS_pubmethodTextFieldParser(String, Encoding, Boolean)

Inicializa una nueva instancia de la clase TextFieldParser.

System_CAPS_pubmethodTextFieldParser(TextReader)

Inicializa una nueva instancia de la clase TextFieldParser.

NombreDescripción
System_CAPS_pubpropertyCommentTokens

Define los símbolos (token) de comentarios. Un símbolo (token) de comentario es una cadena que, cuando se encuentra al principio de una línea, indica que dicha línea es un comentario y que el analizador debe omitirla.

System_CAPS_pubpropertyDelimiters

Define los delimitadores de un archivo de texto.

System_CAPS_pubpropertyEndOfData

Devuelve True si entre la actual posición del cursor y el final del archivo no hay líneas que no estén en blanco ni líneas que no sean comentarios.

System_CAPS_pubpropertyErrorLine

Devuelve la línea que ha causado la excepción MalformedLineException más reciente.

System_CAPS_pubpropertyErrorLineNumber

Devuelve el número de la línea que ha causado la excepción MalformedLineException más reciente.

System_CAPS_pubpropertyFieldWidths

Denota el ancho de cada columna del archivo de texto que se está analizando.

System_CAPS_pubpropertyHasFieldsEnclosedInQuotes

Denota si los campos están entre comillas al analizarse un archivo delimitado.

System_CAPS_pubpropertyLineNumber

Devuelve el actual número de línea o devuelve -1 si no hay más caracteres disponibles en la secuencia.

System_CAPS_pubpropertyTextFieldType

Indica si el archivo que se va a analizar es un archivo delimitado o de ancho fijo.

System_CAPS_pubpropertyTrimWhiteSpace

Indica si los espacios en blanco iniciales y finales deben quitarse de los valores de campo.

NombreDescripción
System_CAPS_pubmethodClose()

Cierra el actual objeto TextFieldParser.

System_CAPS_pubmethodDispose()

Libera los recursos que usa el objeto TextFieldParser.

System_CAPS_protmethodDispose(Boolean)

Libera los recursos que usa el objeto TextFieldParser.

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_protmethodFinalize()

Permite que el objeto TextFieldParser intente liberar recursos y realizar otras operaciones de limpieza antes de que sea reclamado por la recolección de elementos no utilizados.(Invalida Object.Finalize()).

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_pubmethodPeekChars(Int32)

Lee el número especificado de caracteres sin avanzar el cursor.

System_CAPS_pubmethodReadFields()

Lee todos los campos en la línea actual, los devuelve como una matriz de cadenas y avanza el cursor a la siguiente línea que contiene datos.

System_CAPS_pubmethodReadLine()

Devuelve la línea actual como una cadena y avanza el cursor a la siguiente línea.

System_CAPS_pubmethodReadToEnd()

Lee el resto del archivo de texto y lo devuelve como una cadena.

System_CAPS_pubmethodSetDelimiters(String[])

Establece los delimitadores del lector en los valores especificados y establece el tipo de campo en Delimited.

System_CAPS_pubmethodSetFieldWidths(Int32[])

Establece los delimitadores para el lector en los valores especificados.

System_CAPS_pubmethodToString()

Devuelve una cadena que representa el objeto actual.(Heredado de Object).

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

La TextFieldParser puede analizar dos tipos de archivos: delimitados o de ancho fijo. Algunas propiedades, como Delimiters y HasFieldsEnclosedInQuotes sólo son significativos cuando se trabaja con archivos delimitados, mientras que el FieldWidths propiedad solo es significativa cuando trabaja con archivos de ancho fijo.

En la tabla siguiente muestra ejemplos de tareas que implican la Microsoft.VisualBasic.FileIO.TextFieldParser objeto.

Para

Vea

Leer de un archivo de texto delimitado

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

Leer de un archivo de texto de ancho fijo

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

Leer de un archivo de texto con varios formatos

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

En este ejemplo se analiza a través de un archivo de texto delimitado por tabuladores, 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

.NET Framework
Disponible desde 2.0

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: