WorksheetFunction.Search-Methode (Excel)

  • Artikel

Search und SearchB suchen eine Textzeichenfolge innerhalb einer zweiten Textzeichenfolge und geben die Nummer der Anfangsposition der ersten Textzeichenfolge aus dem ersten Zeichen der zweiten Textzeichenfolge zurück.

Syntax

Ausdruck. Suche (Arg1, Arg2, Arg3)

Ausdruck Eine Variable, die ein WorksheetFunction-Objekt darstellt.

Parameter

Name Erforderlich/Optional Datentyp Beschreibung
Arg1 Erforderlich String Find_text – der Text, den Sie suchen möchten.
Arg2 Erforderlich String Text – der Text, in dem nach Suchtext gesucht werden soll.
Arg3 Optional Variant Erstes_Zeichen – die Nummer des Zeichens in Text, an deren Position mit der Suche begonnen werden soll.

Rückgabewert

Double

HinwBemerkungeneise

Die Suche ist für die Verwendung mit Sprachen vorgesehen, die den Single-Byte-Zeichensatz (Single-Byte Character Set, SBCS) verwenden, während SearchB für die Verwendung mit Sprachen vorgesehen ist, die den Double-Byte-Zeichensatz (DBCS) verwenden. Der Rückgabewert wird von der Standardspracheinstellung auf Ihrem Computer folgendermaßen beeinflusst:

  • Bei der Suche wird jedes Einzelne-Byte- oder Doppelbytezeichen immer als 1 zählt, unabhängig von der Standardspracheinstellung.

  • SearchB zählt jedes Doppelbytezeichen als 2, wenn Sie die Bearbeitung einer Sprache aktiviert haben, die DBCS unterstützt, und legt sie dann als Standardsprache fest. Andernfalls zählt SearchB jedes Zeichen als 1.

  • Zu den Sprachen, die DBCS unterstützen, zählen Japanisch, Chinesisch (vereinfacht), Chinesisch (traditionell) und Koreanisch.

Verwenden Sie Search und SearchB , um die Position eines Zeichens oder einer Textzeichenfolge in einer anderen Textzeichenfolge zu bestimmen, sodass Sie den Text mithilfe der Funktionen Mid und MidB oder Replace und ReplaceB ändern können.

Bei Search und SearchB wird die Groß-/Kleinschreibung nicht beachtet. Wenn Sie eine Suche durchführen möchten, bei der die Groß-/Kleinschreibung beachtet wird, können Sie Find und FindB verwenden.

Verwenden Sie die Platzhalterzeichen, Fragezeichen (?) und Sternchen (*) in find_text. Mit einem Fragezeichen erfolgt ein Abgleich mit jedem einzelnen Zeichen; mit einem Stern erfolgt ein Abgleich mit einer beliebigen Abfolge von Zeichen. Wenn Sie nach einem Fragezeichen oder Sternchen suchen möchten, geben Sie vor dem Zeichen eine Tilde (~) ein.

Wenn find_text nicht gefunden wird, #VALUE! zurückgegeben.

Wenn Anzahl_Stellen ausgelassen wird, wird davon ausgegangen, dass dafür der Wert 1 vorliegt.

Wenn Anzahl_Stellen nicht größer als 0 (Null) bzw. größer als die Länge von Text ist, wird der Fehlerwert #VALUE! zurückgegeben.

Verwenden Sie start_num, um eine angegebene Anzahl von Zeichen zu überspringen. Angenommen, Sie arbeiten mit der Textzeichenfolge AYF0093.YoungMensApparel. Um die Nummer der ersten "Y" im beschreibenden Teil der Textzeichenfolge zu finden, legen Sie start_num gleich 8 fest, damit der Seriennummernteil des Texts nicht durchsucht wird. Die Suche beginnt mit zeichen 8, findet find_text beim nächsten Zeichen und gibt die Zahl 9 zurück.

Die Suche gibt immer die Anzahl der Zeichen vom Anfang der within_text zurück, wobei die Zeichen gezählt werden, die Sie überspringen, wenn start_num größer als 1 ist.

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.