Filter-FunktionFilter function

Gibt ein nullbasiertes Array zurück, das eine Teilmenge eines Zeichenfolgenarrays basierend auf einem angegebenen Filterkriterium enthält.Returns a zero-based array containing a subset of a string array based on a specified filter criteria.

SyntaxSyntax

Filter (sourceArray, Match, [ include, [ Compare ]])Filter(sourcearray, match, [ include, [ compare ]])


Die Syntax der Filter -Funktion weist folgende benannte Argumenteauf:The Filter function syntax has these named arguments:

TeilPart BeschreibungDescription
sourceArraysourcearray Erforderlich.Required. Eindimensionales Array mit den zu durchsuchenden Zeichenfolgen.One-dimensional array of strings to be searched.
übereinstimmenmatch Erforderlich.Required. Zeichenfolge, nach der gesucht werden soll.String to search for.
includeinclude Optional.Optional. Boolescher Wert, der angibt, ob Teilzeichenfolgen zurückgegeben werden sollen, die _Übereinstimmungen_einschließen oder ausschließen.Boolean value indicating whether to return substrings that include or exclude match. Wenn include auf truefestgelegt ist, gibt Filter die Teilmenge des Arrays zurück, das die Übereinstimmung als Teilzeichenfolge enthält.If include is True, Filter returns the subset of the array that contains match as a substring. Wenn include den Wert falsehat, gibt Filter die Teilmenge des Arrays zurück, die keine Übereinstimmung als Teilzeichenfolge enthält.If include is False, Filter returns the subset of the array that does not contain match as a substring.
comparecompare Optional.Optional. Numerischer Wert, mit dem die Art des zu verwendenden Zeichenfolgenvergleichs angegeben wird.Numeric value indicating the kind of string comparison to use. Im Abschnitt „Einstellungen“ finden Sie entsprechende Werte.See Settings section for values.

EinstellungenSettings

Das compare-Argument kann die folgenden Werte besitzen:The compare argument can have the following values:

KonstanteConstant WertValue BeschreibungDescription
vbUseCompareOptionvbUseCompareOption -1-1 Führt mit der Einstellung der Option Compare-Anweisung einen Vergleich aus.Performs a comparison by using the setting of the Option Compare statement.
vbBinaryComparevbBinaryCompare 00 Führt einen binären Vergleich aus.Performs a binary comparison.
vbTextComparevbTextCompare 11 Führt einen Textvergleich aus.Performs a textual comparison.
vbDatabaseComparevbDatabaseCompare 22 Nur Microsoft Access.Microsoft Access only. Führt anhand der Informationen in Ihrer Datenbank einen Vergleich aus.Performs a comparison based on information in your database.

Das von der Filter-Funktion zurückgegebene Array enthält nur so viele Elemente, wie für die Anzahl der übereinstimmenden Elemente benötigt.The array returned by the Filter function contains only enough elements to contain the number of matched items.

Siehe auchSee also

Support und FeedbackSupport and feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation?Have questions or feedback about Office VBA or this documentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.