Strings.Filter Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Vrátí matici založenou na nule obsahující podmnožinu pole na základě zadaných String kritérií filtru.
Přetížení
| Name | Description |
|---|---|
| Filter(Object[], String, Boolean, CompareMethod) |
Vrátí matici založenou na nule obsahující podmnožinu pole na základě zadaných |
| Filter(String[], String, Boolean, CompareMethod) |
Vrátí matici založenou na nule obsahující podmnožinu pole na základě zadaných |
Filter(Object[], String, Boolean, CompareMethod)
- Zdroj:
- Strings.vb
- Zdroj:
- Strings.vb
- Zdroj:
- Strings.vb
- Zdroj:
- Strings.vb
- Zdroj:
- Strings.vb
Vrátí matici založenou na nule obsahující podmnožinu pole na základě zadaných String kritérií filtru.
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()
Parametry
- Source
- Object[]
Required. Jednorozměrné pole řetězců, které se mají prohledávat.
- Match
- String
Required. Řetězec, který chcete vyhledat.
- Include
- Boolean
Optional.
Boolean hodnota označující, zda mají být vráceny podřetětěce, které zahrnují nebo vyloučit Match. Pokud Include ano True, Filter vrátí funkce podmnožinu pole, která obsahuje Match jako podřetěc. Pokud Include ano False, Filter vrátí funkce podmnožinu pole, která neobsahuje Match jako podřetěc.
- Compare
- CompareMethod
Optional. Číselná hodnota označující typ porovnání řetězců, který se má použít. Hodnoty najdete v části Nastavení.
Návraty
Matice založená na nule obsahující podmnožinu pole na základě zadaných String kritérií filtru.
Výjimky
Source je Nothing nebo není jednorozměrné pole.
Příklady
Tento příklad ukazuje použití Filter funkce.
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)
Poznámky
Pokud nejsou nalezeny Match žádné shody uvnitř Source, Filter vrátí funkce prázdné pole. Pokud je nastavená Source nebo není jednorozměrné pole, dojde k Nothing chybě.
Pole vrácené Filter funkcí obsahuje pouze dostatek prvků, které obsahují počet odpovídajících položek.
Argument Compare může mít následující hodnoty.
| Konstanta | Description |
|---|---|
CompareMethod.Binary |
Provede binární porovnání. |
CompareMethod.Text |
Provede textové porovnání. |
Viz také
- Replace(String, String, String, Int32, Int32, CompareMethod)
- ArgumentException
- Souhrn manipulace s řetězci
Platí pro
Filter(String[], String, Boolean, CompareMethod)
- Zdroj:
- Strings.vb
- Zdroj:
- Strings.vb
- Zdroj:
- Strings.vb
- Zdroj:
- Strings.vb
- Zdroj:
- Strings.vb
Vrátí matici založenou na nule obsahující podmnožinu pole na základě zadaných String kritérií filtru.
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()
Parametry
- Source
- String[]
Required. Jednorozměrné pole řetězců, které se mají prohledávat.
- Match
- String
Required. Řetězec, který chcete vyhledat.
- Include
- Boolean
Optional.
Boolean hodnota označující, zda mají být vráceny podřetětěce, které zahrnují nebo vyloučit Match. Pokud Include ano True, Filter vrátí funkce podmnožinu pole, která obsahuje Match jako podřetěc. Pokud Include ano False, Filter vrátí funkce podmnožinu pole, která neobsahuje Match jako podřetěc.
- Compare
- CompareMethod
Optional. Číselná hodnota označující typ porovnání řetězců, který se má použít. Hodnoty najdete v části Nastavení.
Návraty
Matice založená na nule obsahující podmnožinu pole na základě zadaných String kritérií filtru.
Výjimky
Source je Nothing nebo není jednorozměrné pole.
Příklady
Tento příklad ukazuje použití Filter funkce.
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)
Poznámky
Pokud nejsou nalezeny Match žádné shody uvnitř Source, Filter vrátí funkce prázdné pole. Pokud je nastavená Source nebo není jednorozměrné pole, dojde k Nothing chybě.
Pole vrácené Filter funkcí obsahuje pouze dostatek prvků, které obsahují počet odpovídajících položek.
Argument Compare může mít následující hodnoty.
| Konstanta | Description |
|---|---|
CompareMethod.Binary |
Provede binární porovnání. |
CompareMethod.Text |
Provede textové porovnání. |
Viz také
- Replace(String, String, String, Int32, Int32, CompareMethod)
- ArgumentException
- Souhrn manipulace s řetězci