TextFieldParser.PeekChars-Methode

Artikel
09/02/2008

Aktualisiert: November 2007

Liest die angegebene Anzahl von Zeichen, ohne den Cursor zu verschieben.

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

Parameter

numberOfChars
Int32. Anzahl der zu lesenden Zeichen. Erforderlich.

Rückgabewert

String.

Ausnahmen

Die folgende Bedingung verursacht möglicherweise das Auslösen einer Ausnahme:

numberOfChars ist kleiner als 0 (ArgumentException).

Hinweise

Der numberOfChars-Wert muss kleiner als die Gesamtzahl der Zeichen in der Zeile sein. Wenn dies nicht der Fall ist, wird die von PeekChars zurückgegebene Zeichenfolge bis zur Länge dieser Zeile abgeschnitten.

Leere Zeilen werden ignoriert.

Zeilenendezeichen werden nicht zurückgegeben.

Die PeekChars-Methode führt keine Analyse aus. Ein Zeilenendezeichen in einem Feld mit Trennzeichen wird als das tatsächliche Zeilenende interpretiert.

Aufgaben

In der folgenden Tabelle werden Beispiele für Aufgaben mit der PeekChars-Methode aufgeführt.

Zweck	Weitere Informationen finden Sie unter
Bestimmen des Feldformats vor dem Analysieren des Felds	Gewusst wie: Lesen aus Textdateien mit mehreren Formaten in Visual Basic

Beispiel

In diesem Beispiel wird PeekChars verwendet, um das Ende der Daten zu bestimmen und die Analyse der Datei an dieser Stelle zu beenden.

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

Anforderungen

Namespace: Microsoft.VisualBasic.FileIO

Klasse: TextFieldParser

Assembly: Visual Basic-Laufzeitbibliothek (in Microsoft.VisualBasic.dll)

Berechtigungen

Die folgenden Berechtigungen sind erforderlich:

Berechtigung	Beschreibung
FileIOPermission	Steuert die Fähigkeit, auf Dateien und Ordner zuzugreifen. Zugeordnete Enumeration: Unrestricted.
SecurityPermission	Beschreibt einen Satz von Sicherheitsberechtigungen, die auf Code angewendet werden. Zugeordnete Enumeration: ControlEvidence.

Weitere Informationen finden Sie unter Codezugriffssicherheit und unter Anfordern von Berechtigungen.

Siehe auch

Freigeben über