共用方式為


Strings.Filter 方法

定義

傳回以零起始的陣列,其中包含以指定篩選準則為依據的 String 陣列子集。

多載

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

傳回以零起始的陣列,其中包含以指定篩選準則為依據的 String 陣列子集。

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

傳回以零起始的陣列,其中包含以指定篩選準則為依據的 String 陣列子集。

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

來源:
Strings.vb
來源:
Strings.vb
來源:
Strings.vb

傳回以零起始的陣列,其中包含以指定篩選準則為依據的 String 陣列子集。

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

參數

Source
Object[]

必要。 要搜尋的一維字串陣列。

Match
String

必要。 要搜尋的字串。

Include
Boolean

選擇性。 Boolean 值,表示是否要傳回包含或排除 Match 的子字串。 如果 IncludeTrue,則 Filter 函式會傳回包含 Match 做為子字串的陣列子集。 如果 IncludeFalse,則 Filter 函式會傳回未包含 Match 做為子字串的陣列子集。

Compare
CompareMethod

選擇性。 數值,表示要使用的字串比較類型。 如需有關值的資訊,請參閱<設定>。

傳回

String[]

以零起始的陣列,其中包含以指定篩選準則為基礎的 String 陣列子集。

例外狀況

SourceNothing 或不是一維陣列。

範例

這個範例示範如何使用 函 Filter 式。

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)

備註

如果在 中找到 Source的相符專案Match,函Filter式會傳回空數位列。 如果 Source 設定 Nothing 為 或 不是一維陣列,就會發生錯誤。

函式傳回的 Filter 數位只包含足以包含相符項目數目的專案。

Compare 變數可以有下列值。

常數 描述
CompareMethod.Binary 執行二進位比較
CompareMethod.Text 執行文字比較

另請參閱

適用於

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

來源:
Strings.vb
來源:
Strings.vb
來源:
Strings.vb

傳回以零起始的陣列,其中包含以指定篩選準則為依據的 String 陣列子集。

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

參數

Source
String[]

必要。 要搜尋的一維字串陣列。

Match
String

必要。 要搜尋的字串。

Include
Boolean

選擇性。 Boolean 值,表示是否要傳回包含或排除 Match 的子字串。 如果 IncludeTrue,則 Filter 函式會傳回包含 Match 做為子字串的陣列子集。 如果 IncludeFalse,則 Filter 函式會傳回未包含 Match 做為子字串的陣列子集。

Compare
CompareMethod

選擇性。 數值,表示要使用的字串比較類型。 如需有關值的資訊,請參閱<設定>。

傳回

String[]

以零起始的陣列,其中包含以指定篩選準則為基礎的 String 陣列子集。

例外狀況

SourceNothing 或不是一維陣列。

範例

這個範例示範如何使用 函 Filter 式。

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)

備註

如果在 中找到 Source的相符專案Match,函Filter式會傳回空數位列。 如果 Source 設定 Nothing 為 或 不是一維陣列,就會發生錯誤。

函式傳回的 Filter 數位只包含足以包含相符項目數目的專案。

Compare 變數可以有下列值。

常數 描述
CompareMethod.Binary 執行二進位比較
CompareMethod.Text 執行文字比較

另請參閱

適用於