WorksheetFunction.Match(Object, Object, Object) Methode

Definition

Namespace:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

Sucht Werte innerhalb eines Bezugs oder einer Matrix. Verwenden Sie Übereinstimmung anstelle einer der Lookup(Object, Object, Object) Funktionen, wenn Sie die Position eines Elements in einem Bereich anstelle des Elements selbst benötigen.

public double Match (object Arg1, object Arg2, object Arg3);

Public Function Match (Arg1 As Object, Arg2 As Object, Optional Arg3 As Object) As Double

Parameter

Arg1

Object

Suchkriterium – der Wert, aufgrund dessen der gewünschte Wert in einer Tabelle gesucht wird.

Arg2

Object

Suchmatrix – ein zusammenhängender Zellbereich mit möglichen Vergleichskriterien. Suchmatrix muss eine Matrix oder ein Bezug auf eine Matrix sein.

Arg3

Object

Vergleichstyp – die Zahl -1, 0 oder 1. Vergleichstyp gibt an, auf welche Weise Microsoft Excel die Werte in einer Suchmatrix mit den Suchkriterien vergleicht.

Gibt zurück

Double

Hinweise

„Lookup_value“ ist der Wert, den Sie in „lookup_array“ abgleichen möchten. Wenn Sie beispielsweise die Nummer einer person in einem Telefonbuch nachschlagen, verwenden Sie den Namen der Person als Nachschlagewert, aber die Telefonnummer ist der gewünschte Wert.

Suchkriterium kann ein Wert (eine Zahl, eine Zeichenfolge oder ein Wahrheitswert) oder ein Bezug auf eine Zelle sein, die eine Zahl, eine Zeichenfolge oder einen Wahrheitswert enthält.

Wenn match_type 1 ist, findet Match den größten Wert, der kleiner oder gleich lookup_value ist. Lookup_array muss in aufsteigender Reihenfolge platziert werden: ...-2, -1, 0, 1, 2, ..., A-Z, false, true.

Wenn match_type 0 ist, findet Match den ersten Wert, der genau gleich lookup_value ist. Die Elemente der Suchmatrix dürfen in beliebiger Reihenfolge angeordnet sein.

Wenn match_type -1 ist, findet Match den kleinsten Wert, der größer oder gleich lookup_value ist. Lookup_array muss in absteigender Reihenfolge platziert werden: true, false, Z-A, ... 2, 1, 0, -1, -2, ... usw. Wenn match_type nicht angegeben wird, wird davon ausgegangen, dass es 1 ist.

Match gibt die Position des abgeglichenen Werts innerhalb lookup_array zurück, nicht den Wert selbst. Match("b",{"a","b","c"},0) gibt beispielsweise 2 zurück, die relative Position von "b" innerhalb des Arrays {"a","b","c"}.

Die Übereinstimmung unterscheidet beim Abgleich von Textwerten nicht zwischen Groß- und Kleinbuchstaben.

Wenn Die Übereinstimmung nicht gefunden werden kann, wird der #N/A-Fehlerwert zurückgegeben.

Ist Vergleichstyp gleich 0 und ist als Suchkriterium eine Zeichenfolge angegeben, können Sie im Suchkriterium Platzhalterzeichen, Fragezeichen und Sternchen (*) verwenden. Ein Fragezeichen ersetzt beim Abgleichen ein einzelnes Zeichen und ein Sternchen eine beliebige Zeichenfolge. Wenn Sie nach einem Fragezeichen oder Sternchen suchen möchten, geben Sie vor dem Zeichen eine Tilde (~) ein.