Freigeben über


Strings.Filter Methode

Definition

Gibt ein nullbasiertes Array zurück, das einen Teilbereich eines String-Arrays auf der Basis angegebener Filterkriterien enthält.

Überlädt

Filter(Object[], String, Boolean, CompareMethod)

Gibt ein nullbasiertes Array zurück, das einen Teilbereich eines String-Arrays auf der Basis angegebener Filterkriterien enthält.

Filter(String[], String, Boolean, CompareMethod)

Gibt ein nullbasiertes Array zurück, das einen Teilbereich eines String-Arrays auf der Basis angegebener Filterkriterien enthält.

Filter(Object[], String, Boolean, CompareMethod)

Quelle:
Strings.vb
Quelle:
Strings.vb
Quelle:
Strings.vb

Gibt ein nullbasiertes Array zurück, das einen Teilbereich eines String-Arrays auf der Basis angegebener Filterkriterien enthält.

public static string[]? Filter (object?[] Source, string? Match, bool Include = true, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);
public static string[] Filter (object[] Source, string Match, bool Include = true, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);
static member Filter : obj[] * string * bool * Microsoft.VisualBasic.CompareMethod -> string[]
Public Function Filter (Source As Object(), Match As String, Optional Include As Boolean = true, Optional Compare As CompareMethod = Microsoft.VisualBasic.CompareMethod.Binary) As String()

Parameter

Source
Object[]

Erforderlich. Eindimensionales Zeichenfolgenarray, das durchsucht werden soll.

Match
String

Erforderlich. Die zu suchende Zeichenfolge.

Include
Boolean

Dies ist optional. Ein Boolean-Wert, der angibt, ob untergeordnete Zeichenfolgen zurückgegeben werden sollen, die Match einschließen oder ausschließen. Wenn IncludeTrue ist, gibt die Filter-Funktion eine Teilmenge des Arrays zurück, die Match als eine untergeordnete Zeichenfolge enthält. Wenn IncludeFalse ist, gibt die Filter-Funktion eine Teilmenge des Arrays zurück, die Match nicht als eine untergeordnete Zeichenfolge enthält.

Compare
CompareMethod

Dies ist optional. Numerischer Wert, der die Art des zu verwendenden Zeichenfolgenvergleichs angibt. Die Werte finden Sie unter „Einstellungen“.

Gibt zurück

String[]

Ein nullbasiertes Array, das einen Teilbereich eines String-Arrays auf der Basis angegebener Filterkriterien enthält.

Ausnahmen

Source ist Nothing oder kein eindimensionales Array.

Beispiele

In diesem Beispiel wird die Verwendung der Filter -Funktion veranschaulicht.

Dim testStrings(2) As String
testStrings(0) = "This"
testStrings(1) = "Is"
testStrings(2) = "It"
Dim subStrings() As String
' Returns ["This", "Is"].
subStrings = Filter(testStrings, "is", True, CompareMethod.Text)
' Returns ["This"].
subStrings = Filter(testStrings, "is", True, CompareMethod.Binary)
' Returns ["Is", "It"].
subStrings = Filter(testStrings, "is", False, CompareMethod.Binary)

Hinweise

Wenn keine Übereinstimmungen von Match in Sourcegefunden werden, gibt die Filter Funktion ein leeres Array zurück. Ein Fehler tritt auf, wenn Source auf Nothing festgelegt ist oder kein eindimensionales Array ist.

Das von der Filter Funktion zurückgegebene Array enthält nur genügend Elemente, um die Anzahl der übereinstimmenden Elemente zu enthalten.

Das Compare Argument kann die folgenden Werte aufweisen.

Konstante BESCHREIBUNG
CompareMethod.Binary Führt einen binären Vergleich aus.
CompareMethod.Text Führt einen Textvergleich aus.

Weitere Informationen

Gilt für:

Filter(String[], String, Boolean, CompareMethod)

Quelle:
Strings.vb
Quelle:
Strings.vb
Quelle:
Strings.vb

Gibt ein nullbasiertes Array zurück, das einen Teilbereich eines String-Arrays auf der Basis angegebener Filterkriterien enthält.

public static string[]? Filter (string?[] Source, string? Match, bool Include = true, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);
public static string[] Filter (string[] Source, string Match, bool Include = true, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);
static member Filter : string[] * string * bool * Microsoft.VisualBasic.CompareMethod -> string[]
Public Function Filter (Source As String(), Match As String, Optional Include As Boolean = true, Optional Compare As CompareMethod = Microsoft.VisualBasic.CompareMethod.Binary) As String()

Parameter

Source
String[]

Erforderlich. Eindimensionales Zeichenfolgenarray, das durchsucht werden soll.

Match
String

Erforderlich. Die zu suchende Zeichenfolge.

Include
Boolean

Dies ist optional. Ein Boolean-Wert, der angibt, ob untergeordnete Zeichenfolgen zurückgegeben werden sollen, die Match einschließen oder ausschließen. Wenn IncludeTrue ist, gibt die Filter-Funktion eine Teilmenge des Arrays zurück, die Match als eine untergeordnete Zeichenfolge enthält. Wenn IncludeFalse ist, gibt die Filter-Funktion eine Teilmenge des Arrays zurück, die Match nicht als eine untergeordnete Zeichenfolge enthält.

Compare
CompareMethod

Dies ist optional. Numerischer Wert, der die Art des zu verwendenden Zeichenfolgenvergleichs angibt. Die Werte finden Sie unter „Einstellungen“.

Gibt zurück

String[]

Ein nullbasiertes Array, das einen Teilbereich eines String-Arrays auf der Basis angegebener Filterkriterien enthält.

Ausnahmen

Source ist Nothing oder kein eindimensionales Array.

Beispiele

In diesem Beispiel wird die Verwendung der Filter -Funktion veranschaulicht.

Dim testStrings(2) As String
testStrings(0) = "This"
testStrings(1) = "Is"
testStrings(2) = "It"
Dim subStrings() As String
' Returns ["This", "Is"].
subStrings = Filter(testStrings, "is", True, CompareMethod.Text)
' Returns ["This"].
subStrings = Filter(testStrings, "is", True, CompareMethod.Binary)
' Returns ["Is", "It"].
subStrings = Filter(testStrings, "is", False, CompareMethod.Binary)

Hinweise

Wenn keine Übereinstimmungen von Match in Sourcegefunden werden, gibt die Filter Funktion ein leeres Array zurück. Ein Fehler tritt auf, wenn Source auf Nothing festgelegt ist oder kein eindimensionales Array ist.

Das von der Filter Funktion zurückgegebene Array enthält nur genügend Elemente, um die Anzahl der übereinstimmenden Elemente zu enthalten.

Das Compare Argument kann die folgenden Werte aufweisen.

Konstante BESCHREIBUNG
CompareMethod.Binary Führt einen binären Vergleich aus.
CompareMethod.Text Führt einen Textvergleich aus.

Weitere Informationen

Gilt für: