TextFieldParser TextFieldParser TextFieldParser TextFieldParser Class

Definition

Proporciona los métodos y propiedades para analizar archivos de texto estructurados. Provides methods and properties for parsing structured text files.

public ref class TextFieldParser : IDisposable
public class TextFieldParser : IDisposable
type TextFieldParser = class
    interface IDisposable
Public Class TextFieldParser
Implements IDisposable
Inheritance
TextFieldParserTextFieldParserTextFieldParserTextFieldParser
Implements

Examples

En este ejemplo se analiza a través de un archivo de texto delimitado por tabuladores, Bigfile.This example parses through a tab-delimited text file, 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

Remarks

La TextFieldParser objeto proporciona métodos y propiedades para analizar archivos de texto estructurados.The TextFieldParser object provides methods and properties for parsing structured text files. 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.Parsing a text file with the TextFieldParser is similar to iterating over a text file, while the ReadFields method to extract fields of text is similar to splitting the strings.

El TextFieldParser puede analizar dos tipos de archivos: delimitado o de ancho fijo.The TextFieldParser can parse two types of files: delimited or fixed-width. Algunas propiedades, como Delimiters y HasFieldsEnclosedInQuotes solo son significativos cuando se trabaja con archivos delimitados, mientras el FieldWidths propiedad es significativa solo cuando se trabaja con archivos de ancho fijo.Some properties, such as Delimiters and HasFieldsEnclosedInQuotes are meaningful only when working with delimited files, while the FieldWidths property is meaningful only when working with fixed-width files.

En la tabla siguiente se muestra ejemplos de tareas que implican la Microsoft.VisualBasic.FileIO.TextFieldParser objeto.The following table lists examples of tasks involving the Microsoft.VisualBasic.FileIO.TextFieldParser object.

EnTo VeaSee
Leer de un archivo de texto delimitadoRead from a delimited text file Leer archivos de texto delimitado por comasHow to: Read From Comma-Delimited Text Files
Leer de un archivo de texto de ancho fijoRead from a fixed-width text file Leer archivos de texto de ancho fijoHow to: Read From Fixed-width Text Files
Leer de un archivo de texto con varios formatosRead from a text file with multiple formats Leer archivos de texto con varios formatosHow to: Read From Text Files with Multiple Formats

Constructors

TextFieldParser(Stream) TextFieldParser(Stream) TextFieldParser(Stream) TextFieldParser(Stream)

Inicializa una nueva instancia de la clase TextFieldParser. Initializes a new instance of the TextFieldParser class.

TextFieldParser(Stream, Encoding) TextFieldParser(Stream, Encoding) TextFieldParser(Stream, Encoding) TextFieldParser(Stream, Encoding)

Inicializa una nueva instancia de la clase TextFieldParser. Initializes a new instance of the TextFieldParser class.

TextFieldParser(Stream, Encoding, Boolean) TextFieldParser(Stream, Encoding, Boolean) TextFieldParser(Stream, Encoding, Boolean) TextFieldParser(Stream, Encoding, Boolean)

Inicializa una nueva instancia de la clase TextFieldParser. Initializes a new instance of the TextFieldParser class.

TextFieldParser(Stream, Encoding, Boolean, Boolean) TextFieldParser(Stream, Encoding, Boolean, Boolean) TextFieldParser(Stream, Encoding, Boolean, Boolean) TextFieldParser(Stream, Encoding, Boolean, Boolean)

Inicializa una nueva instancia de la clase TextFieldParser. Initializes a new instance of the TextFieldParser class.

TextFieldParser(String) TextFieldParser(String) TextFieldParser(String) TextFieldParser(String)

Inicializa una nueva instancia de la clase TextFieldParser. Initializes a new instance of the TextFieldParser class.

TextFieldParser(String, Encoding) TextFieldParser(String, Encoding) TextFieldParser(String, Encoding) TextFieldParser(String, Encoding)

Inicializa una nueva instancia de la clase TextFieldParser. Initializes a new instance of the TextFieldParser class.

TextFieldParser(String, Encoding, Boolean) TextFieldParser(String, Encoding, Boolean) TextFieldParser(String, Encoding, Boolean) TextFieldParser(String, Encoding, Boolean)

Inicializa una nueva instancia de la clase TextFieldParser. Initializes a new instance of the TextFieldParser class.

TextFieldParser(TextReader) TextFieldParser(TextReader) TextFieldParser(TextReader) TextFieldParser(TextReader)

Inicializa una nueva instancia de la clase TextFieldParser. Initializes a new instance of the TextFieldParser class.

Properties

CommentTokens CommentTokens CommentTokens CommentTokens

Define los símbolos (token) de comentarios. Defines comment tokens. 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. A comment token is a string that, when placed at the beginning of a line, indicates that the line is a comment and should be ignored by the parser.

Delimiters Delimiters Delimiters Delimiters

Define los delimitadores de un archivo de texto. Defines the delimiters for a text file.

EndOfData EndOfData EndOfData 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. Returns True if there are no non-blank, non-comment lines between the current cursor position and the end of the file.

ErrorLine ErrorLine ErrorLine ErrorLine

Devuelve la línea que ha causado la excepción MalformedLineException más reciente. Returns the line that caused the most recent MalformedLineException exception.

ErrorLineNumber ErrorLineNumber ErrorLineNumber ErrorLineNumber

Devuelve el número de la línea que ha causado la excepción MalformedLineException más reciente. Returns the number of the line that caused the most recent MalformedLineException exception.

FieldWidths FieldWidths FieldWidths FieldWidths

Denota el ancho de cada columna del archivo de texto que se está analizando. Denotes the width of each column in the text file being parsed.

HasFieldsEnclosedInQuotes HasFieldsEnclosedInQuotes HasFieldsEnclosedInQuotes HasFieldsEnclosedInQuotes

Denota si los campos están entre comillas al analizarse un archivo delimitado. Denotes whether fields are enclosed in quotation marks when a delimited file is being parsed.

LineNumber LineNumber LineNumber LineNumber

Devuelve el actual número de línea o devuelve -1 si no hay más caracteres disponibles en la secuencia. Returns the current line number, or returns -1 if no more characters are available in the stream.

TextFieldType TextFieldType TextFieldType TextFieldType

Indica si el archivo que se va a analizar es un archivo delimitado o de ancho fijo. Indicates whether the file to be parsed is delimited or fixed-width.

TrimWhiteSpace TrimWhiteSpace TrimWhiteSpace TrimWhiteSpace

Indica si los espacios en blanco iniciales y finales deben quitarse de los valores de campo. Indicates whether leading and trailing white space should be trimmed from field values.

Methods

Close() Close() Close() Close()

Cierra el actual objeto TextFieldParser. Closes the current TextFieldParser object.

Dispose() Dispose() Dispose() Dispose()

Libera los recursos que usa el objeto TextFieldParser. Releases resources used by the TextFieldParser object.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Libera los recursos que usa el objeto TextFieldParser. Releases resources used by the TextFieldParser object.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual. Determines whether the specified object is equal to the current object.

(Inherited from Object)
Finalize() Finalize() Finalize() 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. Allows the TextFieldParser object to attempt to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada. Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual. Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del Object actual. Creates a shallow copy of the current Object.

(Inherited from Object)
PeekChars(Int32) PeekChars(Int32) PeekChars(Int32) PeekChars(Int32)

Lee el número especificado de caracteres sin avanzar el cursor. Reads the specified number of characters without advancing the cursor.

ReadFields() ReadFields() ReadFields() 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. Reads all fields on the current line, returns them as an array of strings, and advances the cursor to the next line containing data.

ReadLine() ReadLine() ReadLine() ReadLine()

Devuelve la línea actual como una cadena y avanza el cursor a la siguiente línea. Returns the current line as a string and advances the cursor to the next line.

ReadToEnd() ReadToEnd() ReadToEnd() ReadToEnd()

Lee el resto del archivo de texto y lo devuelve como una cadena. Reads the remainder of the text file and returns it as a string.

SetDelimiters(String[]) SetDelimiters(String[]) SetDelimiters(String[]) SetDelimiters(String[])

Establece los delimitadores del lector en los valores especificados y establece el tipo de campo en Delimited. Sets the delimiters for the reader to the specified values, and sets the field type to Delimited.

SetFieldWidths(Int32[]) SetFieldWidths(Int32[]) SetFieldWidths(Int32[]) SetFieldWidths(Int32[])

Establece los delimitadores para el lector en los valores especificados. Sets the delimiters for the reader to the specified values.

ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual. Returns a string that represents the current object.

(Inherited from Object)

Applies to

See Also