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
|
TextFieldParser (Clase)
Proporciona los métodos y propiedades para analizar archivos de texto estructurados.
Ensamblado: Microsoft.VisualBasic (en Microsoft.VisualBasic.dll)
El tipo TextFieldParser expone los siguientes miembros.
| Nombre | Descripción | |
|---|---|---|
|
TextFieldParser(Stream) | 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. |
|
TextFieldParser(Stream, Encoding) | Inicializa una nueva instancia de la clase TextFieldParser. |
|
TextFieldParser(String, Encoding) | Inicializa una nueva instancia de la clase TextFieldParser. |
|
TextFieldParser(Stream, Encoding, Boolean) | Inicializa una nueva instancia de la clase TextFieldParser. |
|
TextFieldParser(String, Encoding, Boolean) | Inicializa una nueva instancia de la clase TextFieldParser. |
|
TextFieldParser(Stream, Encoding, Boolean, Boolean) | Inicializa una nueva instancia de la clase TextFieldParser. |
| Nombre | Descripción | |
|---|---|---|
|
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. |
|
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 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. |
| Nombre | Descripción | |
|---|---|---|
|
Close | Cierra el actual objeto TextFieldParser. |
|
Dispose() | Libera los recursos utilizados por el objeto TextFieldParser. |
|
Dispose(Boolean) | Libera los recursos utilizados por el objeto TextFieldParser. |
|
Equals(Object) | Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object). |
|
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()). |
|
GetHashCode | Actúa como función hash para un tipo concreto. (Se hereda de Object). |
|
GetType | Obtiene el objeto Type de la instancia actual. (Se hereda de Object). |
|
MemberwiseClone | Crea una copia superficial del objeto Object actual. (Se hereda de Object). |
|
PeekChars | 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 | Establece los delimitadores del lector en los valores especificados y establece el tipo de campo en Delimited. |
|
SetFieldWidths | Establece los delimitadores para el lector en los valores especificados. |
|
ToString | Devuelve una cadena que representa el objeto actual. (Se hereda de Object). |
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 |
|
|
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.
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.