Freigeben über


InStr-Funktion (Visual Basic)

Aktualisiert: November 2007

Gibt einen Integer-Wert zurück, der die Anfangsposition des ersten Auftretens einer Zeichenfolge innerhalb einer anderen Zeichenfolge angibt.

Public Shared Function InStr(_
   ByVal String1 As String, _
   ByVal String2 As String, _
   Optional ByVal Compare As CompareMethod _
) As Integer
' -or-
Public Shared Function InStr(_
   ByVal Start As Integer, _
   ByVal String1 As String, _
   ByVal String2 As String, _
   Optional ByVal Compare As Microsoft.VisualBasic.CompareMethod _
) As Integer

Parameter

  • Start
    Optional. Numerischer Ausdruck, der die Anfangsposition für jede Suche festlegt. Wird hierfür kein Wert angegeben, beginnt die Suche mit dem ersten Zeichen. Der Startindex beginnt mit dem Wert 1.

  • String1
    Erforderlich. String-Ausdruck, der durchsucht wird.

  • String2
    Erforderlich. String-Ausdruck, nach dem gesucht wird.

  • Compare
    Optional. Gibt den Typ des Zeichenfolgenvergleichs an. Wenn kein Wert für Compare angegeben wird, wird der Vergleichstyp durch die Option Compare-Einstellung festgelegt.

Einstellungen

Die Einstellungen für das Compare-Argument sind:

Konstante

Wert

Beschreibung

Binary

0

Führt einen binären Vergleich durch

Text

1

Führt einen Textvergleich durch.

Rückgabewert

Voraussetzung

Rückgabewert von InStr

String1 ist eine Zeichenfolge mit der Länge 0 (null) oder Nothing

0

String2 ist eine Zeichenfolge mit der Länge 0 (null) oder Nothing

start

String2 wird nicht gefunden

0

String2 wird gefunden innerhalb von String1

Position, an der die gefundene Zeichenfolge beginnt

Start > String2

0

Ausnahmen

Ausnahmetyp

Fehlernummer

Bedingung

ArgumentException

5

Start < 1.

Beachten Sie die Spalte "Fehlernummer", wenn Sie Visual Basic 6.0-Anwendungen aktualisieren, die eine unstrukturierte Fehlerbehandlung verwenden. (Sie können die Fehlernummer mit der Number-Eigenschaft (Err-Objekt) vergleichen.) Wenn möglich, sollten Sie jedoch erwägen, eine solche Fehlersteuerung durch eine Übersicht über die strukturierte Ausnahmebehandlung für Visual Basic zu ersetzen.

Hinweise

I. d. R. wird die InStr-Funktion beim Analysieren von Zeichenfolgen verwendet.

Hinweis:

Die InStrB-Funktion aus früheren Versionen von Visual Basic gibt eine Reihe von Bytes zurück und keine Zeichenposition. Sie wird primär zum Konvertieren von Zeichenfolgen in DBCS (Double-Byte Character Set)-Anwendungen verwendet. Alle Visual Basic 2005-Zeichenfolgen haben das Unicode-Format, und InStrB wird nicht mehr unterstützt.

Beispiel

In diesem Beispiel wird die InStr-Funktion verwendet, um die Position des ersten Auftretens einer Zeichenfolge innerhalb einer anderen Zeichenfolge zurückzugeben.

' String to search in.
Dim SearchString As String = "XXpXXpXXPXXP"
' Search for "P".
Dim SearchChar As String = "P"

Dim TestPos As Integer
' A textual comparison starting at position 4. Returns 6.
TestPos = InStr(4, SearchString, SearchChar, CompareMethod.Text)

' A binary comparison starting at position 1. Returns 9.
TestPos = InStr(1, SearchString, SearchChar, CompareMethod.Binary)

' If Option Compare is not set, or set to Binary, return 9.
' If Option Compare is set to Text, returns 3.
TestPos = InStr(SearchString, SearchChar)

' Returns 0.
TestPos = InStr(1, SearchString, "W")

Anforderungen

Namespace:Microsoft.VisualBasic

**Modul:**Strings

**Assembly:**Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Siehe auch

Konzepte

Änderungen an der Unterstützung von Programmierelementen (Zusammenfassung)

Referenz

InStrRev-Funktion (Visual Basic)

Option Compare-Anweisung

StrComp-Funktion (Visual Basic)

ArgumentException

Weitere Ressourcen

Zeichenfolgen in Visual Basic

Einführung in Zeichenfolgen in Visual Basic