TextFieldParser Classe

Definizione

Fornisce i metodi e le proprietà per l'analisi dei file di testo strutturati.

public ref class TextFieldParser : IDisposable
public class TextFieldParser : IDisposable
type TextFieldParser = class
    interface IDisposable
Public Class TextFieldParser
Implements IDisposable
Ereditarietà
TextFieldParser
Implementazioni

Esempio

In questo esempio viene analizzato un file di testo delimitato da schede, 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

Commenti

L'oggetto TextFieldParser fornisce metodi e proprietà per analizzare i file di testo strutturati. L'analisi di un file di testo con l'oggetto è simile all'iterazione TextFieldParser su un file di testo, mentre l'uso del ReadFields metodo per estrarre i campi di testo è simile alla suddivisione delle stringhe.

L'oggetto TextFieldParser può analizzare due tipi di file: delimitati o a larghezza fissa. Alcune proprietà, ad esempio Delimiters e HasFieldsEnclosedInQuotes sono significative solo quando si utilizzano file delimitati, mentre la FieldWidths proprietà è significativa solo quando si utilizzano file a larghezza fissa.

Nella tabella seguente sono elencati esempi di attività che coinvolgono l'oggetto Microsoft.VisualBasic.FileIO.TextFieldParser .

A Vedere
Lettura da un file di testo delimitato Procedura: Leggere da file di testo con valori delimitati da virgole
Leggere da un file di testo a larghezza fissa Procedura: Leggere da file di testo a larghezza fissa
Leggere da un file di testo con più formati Procedura: Leggere da file di testo con più formati

Costruttori

TextFieldParser(Stream, Encoding, Boolean, Boolean)

Inizializza una nuova istanza della classe TextFieldParser.

TextFieldParser(Stream, Encoding, Boolean)

Inizializza una nuova istanza della classe TextFieldParser.

TextFieldParser(Stream, Encoding)

Inizializza una nuova istanza della classe TextFieldParser.

TextFieldParser(Stream)

Inizializza una nuova istanza della classe TextFieldParser.

TextFieldParser(String, Encoding, Boolean)

Inizializza una nuova istanza della classe TextFieldParser.

TextFieldParser(String, Encoding)

Inizializza una nuova istanza della classe TextFieldParser.

TextFieldParser(String)

Inizializza una nuova istanza della classe TextFieldParser.

TextFieldParser(TextReader)

Inizializza una nuova istanza della classe TextFieldParser.

Proprietà

CommentTokens

Definisce i token di commento. Un token di commento è una stringa che, se posizionata all'inizio di una riga, indica che la riga è un commento e deve essere ignorata dal parser.

Delimiters

Definisce i delimitatori per un file di testo.

EndOfData

Restituisce True se non sono presenti righe non vuote o righe non di commento tra la posizione del cursore corrente e la fine del file.

ErrorLine

Restituisce la riga che ha provocato la generazione dell'eccezione MalformedLineException più recente.

ErrorLineNumber

Restituisce il numero della riga che ha provocato la generazione dell'eccezione MalformedLineException più recente.

FieldWidths

Indica la larghezza di ogni colonna nel file di testo da analizzare.

HasFieldsEnclosedInQuotes

Indica se i campi sono racchiusi tra virgolette quando un file delimitato viene analizzato.

LineNumber

Restituisce il numero di riga corrente oppure -1 se non sono disponibili ulteriori caratteri all'interno del flusso.

TextFieldType

Indica se il file da analizzare è delimitato o a larghezza fissa.

TrimWhiteSpace

Indica se gli spazi vuoti iniziale e finale devono essere tagliati dai valori dei campi.

Metodi

Close()

Chiude l'oggetto TextFieldParser corrente.

Dispose()

Rilascia le risorse usate dall'oggetto TextFieldParser.

Dispose(Boolean)

Rilascia le risorse usate dall'oggetto TextFieldParser.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
Finalize()

Consente all'oggetto TextFieldParser di provare a liberare risorse ed eseguire altre operazioni di pulitura prima che l'oggetto stesso venga recuperato dalla procedura di Garbage Collection.

GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
PeekChars(Int32)

Legge il numero di caratteri specificato senza spostare in avanti il cursore.

ReadFields()

Legge tutti i campi nella riga corrente, li restituisce come una matrice di stringhe e sposta il cursore alla riga successiva contenente dati.

ReadLine()

Restituisce la riga corrente come stringa e sposta il cursore alla riga successiva.

ReadToEnd()

Legge il resto del file di testo e lo restituisce come stringa.

SetDelimiters(String[])

Imposta i delimitatori per il lettore sui valori specificati e imposta il tipo di campo su Delimited.

SetFieldWidths(Int32[])

Imposta i delimitatori per il lettore sui valori specificati.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Implementazioni dell'interfaccia esplicita

IDisposable.Dispose()

Rilascia le risorse usate dall'oggetto TextFieldParser.

Si applica a

Vedi anche