Metodo TextFieldParser.PeekChars

Articolo
09/12/2008

Aggiornamento: novembre 2007

Legge il numero di caratteri specificato senza far avanzare il cursore.

' Usage
Dim value As String = TextFieldParserObject.PeekChars(numberOfChars)
' Declaration
Public Function PeekChars( _
   ByVal numberOfChars As Integer _
) As String

Parametri

numberOfChars
Int32. Numero di caratteri da leggere. Obbligatorio.

Valore restituito

String.

Eccezioni

La seguente condizione può causare la generazione di un'eccezione:

numberOfChars è minore di 0 (ArgumentException).

Note

Il valore numberOfChars deve essere inferiore al numero totale dei caratteri presenti nella riga. In caso contrario, la stringa restituita dall'oggetto PeekChars viene troncata alla lunghezza della riga.

Le righe vuote vengono ignorate.

I caratteri di fine riga non vengono restituiti.

Il metodo PeekChars non effettua alcuna analisi; un carattere di fine riga all'interno di un campo delimitato viene interpretato come fine effettiva della riga.

Attività

Nella tabella riportata di seguito sono elencati esempi di attività relative al metodo PeekChars.

Per	Vedere
Determina il formato di un campo prima di analizzarlo	Procedura: leggere file di testo con più formati in Visual Basic

Esempio

In questo esempio, PeekChars viene utilizzato per individuare la fine dei dati e interrompere l'analisi del file in quel punto.

Using MyReader As New Microsoft.VisualBasic.FileIO.TextFieldParser("C:\ParserText.txt")
    MyReader.TextFieldType = Microsoft.VisualBasic.FileIO.FieldType.Delimited
    MyReader.Delimiters = New String() {","}
    MyReader.CommentTokens = New String() {"'"}
    Dim currentRow As String()
    While (MyReader.PeekChars(1) IsNot "")
        Try
            currentRow = MyReader.ReadFields()
            For Each currentField As String In currentRow
                My.Computer.FileSystem.WriteAllText _
               ("C://testfile.txt", currentField, True)
            Next
        Catch ex As Microsoft.VisualBasic.FileIO.MalformedLineException
            MsgBox("Line " & ex.Message & " is invalid.  Skipping")
        End Try
    End While
End Using

Requisiti

Spazio dei nomi:Microsoft.VisualBasic.FileIO

Classe:TextFieldParser

Assembly: libreria di runtime di Visual Basic (in Microsoft.VisualBasic.dll)

Autorizzazioni

Sono richieste le seguenti autorizzazioni:

Autorizzazione	Descrizione
FileIOPermission	Controlla la possibilità di accedere ai file e alle cartelle. Enumerazione associata: Unrestricted.
SecurityPermission	Descrive un insieme di autorizzazioni di protezione applicate al codice. Enumerazione associata: ControlEvidence.

Per ulteriori informazioni, vedere Protezione dall'accesso di codice e Richiesta di autorizzazioni.

Vedere anche

Condividi tramite