Strings.Filter Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 |
| Filter(String[], String, Boolean, CompareMethod) |
Gibt ein nullbasiertes Array zurück, das einen Teilbereich eines |
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
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
- Replace(String, String, String, Int32, Int32, CompareMethod)
- ArgumentException
- Zeichenfolgenbearbeitung: Zusammenfassung
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
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
- Replace(String, String, String, Int32, Int32, CompareMethod)
- ArgumentException
- Zeichenfolgenbearbeitung: Zusammenfassung