Strings.Filter Metoda

Definicja

Przestrzeń nazw:

Microsoft.VisualBasic

Zestaw:

Microsoft.VisualBasic.Core.dll

Zwraca tablicę opartą na zerach zawierającą podzbiór tablicy String na podstawie określonych kryteriów filtrowania.

Przeciążenia

Nazwa	Opis
Filter(Object[], String, Boolean, CompareMethod)	Zwraca tablicę opartą na zerach zawierającą podzbiór tablicy String na podstawie określonych kryteriów filtrowania.
Filter(String[], String, Boolean, CompareMethod)	Zwraca tablicę opartą na zerach zawierającą podzbiór tablicy String na podstawie określonych kryteriów filtrowania.

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

Źródło:

Strings.vb

Zwraca tablicę opartą na zerach zawierającą podzbiór tablicy String na podstawie określonych kryteriów filtrowania.

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. Jednowymiarowa tablica ciągów do przeszukania.

Match

String

Required. Ciąg do wyszukania.

Include

Boolean

Optional. Boolean wartość wskazująca, czy zwracać podciągy, które zawierają lub wykluczają Match. Jeśli Include parametr ma Truewartość , Filter funkcja zwraca podzbiór tablicy zawierającej Match jako podciąg. Jeśli Include parametr ma Falsewartość , Filter funkcja zwraca podzbiór tablicy, która nie zawiera Match jako podciąg.

Compare

CompareMethod

Optional. Wartość liczbowa wskazująca rodzaj porównania ciągów, którego należy użyć. Zobacz "Ustawienia" dla wartości.

Zwraca

String[]

Tablica oparta na zera zawierająca podzbiór String tablicy na podstawie określonych kryteriów filtrowania.

Wyjątki

ArgumentException

Source jest Nothing tablicą jednowymiarową lub nie jest tablicą jednowymiarową.

Przykłady

W tym przykładzie pokazano użycie Filter funkcji.

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)

Uwagi

Jeśli w obrębie Matchfunkcji nie znaleziono żadnych dopasowańSource, Filter funkcja zwraca pustą tablicę. Błąd występuje, jeśli Source jest ustawiona na Nothing lub nie jest tablicą jednowymiarową.

Tablica zwracana przez Filter funkcję zawiera tylko wystarczająco dużo elementów, aby zawierały liczbę dopasowanych elementów.

Argument Compare może mieć następujące wartości.

Stała	Opis
CompareMethod.Binary	Wykonuje porównanie binarne
CompareMethod.Text	Wykonuje porównanie tekstowe

Zobacz też

• Replace(String, String, String, Int32, Int32, CompareMethod)
• ArgumentException
• Podsumowanie manipulowania ciągami

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

Źródło:

Strings.vb

Zwraca tablicę opartą na zerach zawierającą podzbiór tablicy String na podstawie określonych kryteriów filtrowania.

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. Jednowymiarowa tablica ciągów do przeszukania.

Match

String

Required. Ciąg do wyszukania.

Include

Boolean

Optional. Boolean wartość wskazująca, czy zwracać podciągy, które zawierają lub wykluczają Match. Jeśli Include parametr ma Truewartość , Filter funkcja zwraca podzbiór tablicy zawierającej Match jako podciąg. Jeśli Include parametr ma Falsewartość , Filter funkcja zwraca podzbiór tablicy, która nie zawiera Match jako podciąg.

Compare

CompareMethod

Optional. Wartość liczbowa wskazująca rodzaj porównania ciągów, którego należy użyć. Zobacz "Ustawienia" dla wartości.

Zwraca

String[]

Tablica oparta na zera zawierająca podzbiór String tablicy na podstawie określonych kryteriów filtrowania.

Wyjątki

ArgumentException

Source jest Nothing tablicą jednowymiarową lub nie jest tablicą jednowymiarową.

Przykłady

W tym przykładzie pokazano użycie Filter funkcji.

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)

Uwagi

Jeśli w obrębie Matchfunkcji nie znaleziono żadnych dopasowańSource, Filter funkcja zwraca pustą tablicę. Błąd występuje, jeśli Source jest ustawiona na Nothing lub nie jest tablicą jednowymiarową.

Tablica zwracana przez Filter funkcję zawiera tylko wystarczająco dużo elementów, aby zawierały liczbę dopasowanych elementów.

Argument Compare może mieć następujące wartości.

Stała	Opis
CompareMethod.Binary	Wykonuje porównanie binarne
CompareMethod.Text	Wykonuje porównanie tekstowe

Zobacz też

• Replace(String, String, String, Int32, Int32, CompareMethod)
• ArgumentException
• Podsumowanie manipulowania ciągami