TextFieldParser Classe

Definizione

Spazio dei nomi:
Microsoft.VisualBasic.FileIO
Assembly:
Microsoft.VisualBasic.dll

Fornisce metodi e proprietà per l'analisi di 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 tabulazioni, 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 fornisce metodi e proprietà per l'analisi TextFieldParser di file di testo strutturati. L'analisi di un file di testo con TextFieldParser è simile all'iterazione su un file di testo, mentre l'uso del ReadFields metodo per estrarre campi di testo è simile alla divisione delle stringhe.

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.

Per Vedi
Leggere da un file di testo delimitato Procedura: Leggere da Comma-Delimited file di testo
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 di commento non vuote tra la posizione corrente del cursore e la fine del file.
ErrorLine

Restituisce la riga che ha causato l'eccezione più recente MalformedLineException .
ErrorLineNumber

Restituisce il numero della riga che ha causato l'eccezione più recente MalformedLineException .
FieldWidths

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

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

Restituisce il numero di riga corrente o restituisce -1 se nel flusso non sono disponibili altri caratteri.
TextFieldType

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

Indica se gli spazi vuoti iniziali e finali devono essere eliminati dai valori dei campi.

Metodi

Nome Descrizione
Close()

Chiude l'oggetto corrente TextFieldParser .
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 tentare di liberare risorse ed eseguire altre operazioni di pulizia prima che venga recuperata da Garbage Collection.
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
PeekChars(Int32)

Legge il numero specificato di caratteri senza avanzare il cursore.
ReadFields()

Legge tutti i campi nella riga corrente, li restituisce come matrice di stringhe e sposta il cursore alla riga successiva contenente i 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)

Si applica a

Vedi anche