TextFieldParser Classe

Definizione

Spazio dei nomi:

Microsoft.VisualBasic.FileIO

Assembly:

Microsoft.VisualBasic.Core.dll

Origine:

TextFieldParser.vb

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à

Object

TextFieldParser

Implementazioni

IDisposable

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

Nome	Descrizione
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à

Nome	Descrizione
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

Nome	Descrizione
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)

Vedi anche

• OpenTextFieldParser(String)
• Oggetti (Visual Basic)
• Analisi dei file di testo con l'oggetto TextFieldParser
• Risoluzione dei problemi relativi alle eccezioni: Microsoft.VisualBasic.FileIO.TextFieldParser.MalformedLineException