Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original.
Traducción
Original
Este tema aún no ha recibido ninguna valoración - Valorar este tema

TextFieldParser (Clase)

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

System.Object
  Microsoft.VisualBasic.FileIO.TextFieldParser

Espacio de nombres:  Microsoft.VisualBasic.FileIO
Ensamblado:  Microsoft.VisualBasic (en Microsoft.VisualBasic.dll)
public class TextFieldParser : IDisposable

El tipo TextFieldParser expone los siguientes miembros.

  Nombre Descripción
Método público TextFieldParser(Stream) Inicializa una nueva instancia de la clase TextFieldParser.
Método público TextFieldParser(String) Inicializa una nueva instancia de la clase TextFieldParser.
Método público TextFieldParser(TextReader) Inicializa una nueva instancia de la clase TextFieldParser.
Método público TextFieldParser(Stream, Encoding) Inicializa una nueva instancia de la clase TextFieldParser.
Método público TextFieldParser(String, Encoding) Inicializa una nueva instancia de la clase TextFieldParser.
Método público TextFieldParser(Stream, Encoding, Boolean) Inicializa una nueva instancia de la clase TextFieldParser.
Método público TextFieldParser(String, Encoding, Boolean) Inicializa una nueva instancia de la clase TextFieldParser.
Método público TextFieldParser(Stream, Encoding, Boolean, Boolean) Inicializa una nueva instancia de la clase TextFieldParser.
Arriba
  Nombre Descripción
Propiedad pública CommentTokens Define los símbolos (token) de comentarios. Un símbolo (token) de comentario es una que 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.
Propiedad pública Delimiters Define los delimitadores de un archivo de texto.
Propiedad pública EndOfData Devuelve True si entre la actual posición del cursor y el final del archivo no hay líneas en blanco ni líneas que no sean comentarios.
Propiedad pública ErrorLine Devuelve la línea que ha causado la excepción MalformedLineException más reciente.
Propiedad pública ErrorLineNumber Devuelve el número de la línea que ha causado la excepción MalformedLineException más reciente.
Propiedad pública FieldWidths Denota el ancho de cada columna del archivo de texto que se está analizando.
Propiedad pública HasFieldsEnclosedInQuotes Denota si los campos están entre comillas al analizarse un archivo delimitado.
Propiedad pública LineNumber Devuelve el actual número de línea o devuelve -1 si no hay más caracteres disponibles en la secuencia.
Propiedad pública TextFieldType Indica si el archivo que se va a analizar es un archivo delimitado o de ancho fijo.
Propiedad pública TrimWhiteSpace Indica si los espacios en blanco iniciales y finales deben quitarse de los valores de campo.
Arriba
  Nombre Descripción
Método público Close Cierra el actual objeto TextFieldParser.
Método público Dispose() Libera los recursos utilizados por el objeto TextFieldParser.
Método protegido Dispose(Boolean) Libera los recursos utilizados por el objeto TextFieldParser.
Método público Equals(Object) Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object).
Método protegido Finalize Permite que el objeto TextFieldParser intente liberar recursos y realizar otras operaciones de limpieza antes de que sea reclamado por el recolector de elementos no utilizados. (Invalida a Object.Finalize()).
Método público GetHashCode Actúa como función hash para un tipo concreto. (Se hereda de Object).
Método público GetType Obtiene el objeto Type de la instancia actual. (Se hereda de Object).
Método protegido MemberwiseClone Crea una copia superficial del objeto Object actual. (Se hereda de Object).
Método público PeekChars Lee el número especificado de caracteres sin avanzar el cursor.
Método público 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.
Método público ReadLine Devuelve la línea actual como una cadena y avanza el cursor a la siguiente línea.
Método público ReadToEnd Lee el resto del archivo de texto y lo devuelve como una cadena.
Método público SetDelimiters Establece los delimitadores del lector en los valores especificados y establece el tipo de campo en Delimited.
Método público SetFieldWidths Establece los delimitadores para el lector en los valores especificados.
Método público ToString Devuelve una cadena que representa el objeto actual. (Se hereda de Object).
Arriba

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.

En la tabla siguiente se muestran ejemplos de tareas en la que está implicado el 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

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.

.NET Framework

Compatible con: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.
¿Le ha resultado útil?
(Caracteres restantes: 1500)
Contenido de la comunidad Agregar