TextFieldParser Clase

Definición

Espacio de nombres:

Microsoft.VisualBasic.FileIO

Ensamblado:

Microsoft.VisualBasic.Core.dll

Source:

TextFieldParser.vb

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

public ref class TextFieldParser : IDisposable

public class TextFieldParser : IDisposable

type TextFieldParser = class
    interface IDisposable

Public Class TextFieldParser
Implements IDisposable

Herencia

Object

TextFieldParser

Implementaciones

IDisposable

Ejemplos

En este ejemplo se analiza a través de 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

Comentarios

El TextFieldParser objeto 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 el uso del ReadFields método 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 , solo son significativas cuando se trabaja con archivos delimitados, mientras que la FieldWidths propiedad solo es significativa cuando se trabaja con archivos de ancho fijo.

En la tabla siguiente, se enumeran ejemplos de las tareas que implican el objeto Microsoft.VisualBasic.FileIO.TextFieldParser.

En	Vea
Lectura desde un archivo de texto delimitado	Procedimiento para leer archivos de texto delimitado por comas
Lectura desde un archivo de texto de ancho fijo	Procedimiento para leer archivos de texto de ancho fijo
Lectura desde un archivo de texto con varios formatos	Procedimiento para leer archivos de texto con varios formatos

Constructores

TextFieldParser(Stream, Encoding, Boolean, Boolean)	Inicializa una nueva instancia de la clase TextFieldParser.
TextFieldParser(Stream, Encoding, Boolean)	Inicializa una nueva instancia de la clase TextFieldParser.
TextFieldParser(Stream, Encoding)	Inicializa una nueva instancia de la clase TextFieldParser.
TextFieldParser(Stream)	Inicializa una nueva instancia de la clase TextFieldParser.
TextFieldParser(String, Encoding, Boolean)	Inicializa una nueva instancia de la clase TextFieldParser.
TextFieldParser(String, Encoding)	Inicializa una nueva instancia de la clase TextFieldParser.
TextFieldParser(String)	Inicializa una nueva instancia de la clase TextFieldParser.
TextFieldParser(TextReader)	Inicializa una nueva instancia de la clase TextFieldParser.

Propiedades

CommentTokens	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.
Delimiters	Define los delimitadores de un archivo de texto.
EndOfData	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.
ErrorLine	Devuelve la línea que ha causado la excepción MalformedLineException más reciente.
ErrorLineNumber	Devuelve el número de la línea que ha causado la excepción MalformedLineException más reciente.
FieldWidths	Denota el ancho de cada columna del archivo de texto que se está analizando.
HasFieldsEnclosedInQuotes	Denota si los campos están entre comillas al analizarse un archivo delimitado.
LineNumber	Devuelve el actual número de línea o devuelve -1 si no hay más caracteres disponibles en la secuencia.
TextFieldType	Indica si el archivo que se va a analizar es un archivo delimitado o de ancho fijo.
TrimWhiteSpace	Indica si los espacios en blanco iniciales y finales deben quitarse de los valores de campo.

Métodos

Close()	Cierra el actual objeto TextFieldParser.
Dispose()	Libera los recursos que usa el objeto TextFieldParser.
Dispose(Boolean)	Libera los recursos que usa el objeto TextFieldParser.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
Finalize()	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.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
PeekChars(Int32)	Lee el número especificado de caracteres sin avanzar el cursor.
ReadFields()	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.
ReadLine()	Devuelve la línea actual como una cadena y avanza el cursor a la siguiente línea.
ReadToEnd()	Lee el resto del archivo de texto y lo devuelve como una cadena.
SetDelimiters(String[])	Establece los delimitadores del lector en los valores especificados y establece el tipo de campo en Delimited.
SetFieldWidths(Int32[])	Establece los delimitadores para el lector en los valores especificados.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Consulte también

• OpenTextFieldParser(String)
• Objetos (Visual Basic)
• Analizar archivos de texto con el objeto TextFieldParser
• Solución de problemas de excepciones: Microsoft.VisualBasic.FileIO.TextFieldParser.MalformedLineException