Udostępnij za pośrednictwem


Strings.Filter Metoda

Definicja

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

Przeciążenia

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

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

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

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

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

Źródło:
Strings.vb
Źródło:
Strings.vb
Źródło:
Strings.vb

Zwraca tablicę opartą na zerze zawierającą podzbiór String tablicy 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);
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[]

Wymagane. Jednowymiarowa tablica ciągów do przeszukania.

Match
String

Wymagane. Ciąg do wyszukania.

Include
Boolean

Opcjonalny. Boolean wartość wskazująca, czy zwracać podciągy, które zawierają, czy 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

Opcjonalny. Wartość liczbowa wskazująca rodzaj porównania ciągów do użycia. W przypadku wartości zobacz sekcję „Ustawienia".

Zwraca

String[]

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

Wyjątki

Source jest Nothing tablicą jednowymiarową lub nie jest.

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 programie Sourcenie znaleziono dopasowań Match elementu , 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 tyle 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ż

Dotyczy

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

Źródło:
Strings.vb
Źródło:
Strings.vb
Źródło:
Strings.vb

Zwraca tablicę opartą na zerze zawierającą podzbiór String tablicy 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);
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[]

Wymagane. Jednowymiarowa tablica ciągów do przeszukania.

Match
String

Wymagane. Ciąg do wyszukania.

Include
Boolean

Opcjonalny. Boolean wartość wskazująca, czy zwracać podciągy, które zawierają, czy 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

Opcjonalny. Wartość liczbowa wskazująca rodzaj porównania ciągów do użycia. W przypadku wartości zobacz sekcję „Ustawienia".

Zwraca

String[]

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

Wyjątki

Source jest Nothing tablicą jednowymiarową lub nie jest.

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 programie Sourcenie znaleziono dopasowań Match elementu , 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 tyle 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ż

Dotyczy