Strings.Filter Methode

Definition

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

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

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);

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

ArgumentException

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

• Replace(String, String, String, Int32, Int32, CompareMethod)
• ArgumentException
• Zeichenfolgenbearbeitung: Zusammenfassung

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

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);

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

ArgumentException

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

• Replace(String, String, String, Int32, Int32, CompareMethod)
• ArgumentException
• Zeichenfolgenbearbeitung: Zusammenfassung