Strings.Filter 方法

定義

命名空間:

Microsoft.VisualBasic

組件:

Microsoft.VisualBasic.Core.dll

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

多載

Filter(Object[], String, Boolean, CompareMethod)	傳回以零起始的陣列，其中包含以指定篩選準則為依據的 String 陣列子集。
Filter(String[], String, Boolean, CompareMethod)	傳回以零起始的陣列，其中包含以指定篩選準則為依據的 String 陣列子集。

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

來源:

Strings.vb

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

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 的子字串。 如果 Include 為 True，則 Filter 函式會傳回包含 Match 做為子字串的陣列子集。 如果 Include 為 False，則 Filter 函式會傳回未包含 Match 做為子字串的陣列子集。

Compare

CompareMethod

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

傳回

String[]

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

例外狀況

ArgumentException

Source 是 Nothing 或不是一維陣列。

範例

這個範例示範如何使用 函 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	執行文字比較

另請參閱

• Replace(String, String, String, Int32, Int32, CompareMethod)
• ArgumentException
• 字串操作摘要

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

來源:

Strings.vb

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

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 的子字串。 如果 Include 為 True，則 Filter 函式會傳回包含 Match 做為子字串的陣列子集。 如果 Include 為 False，則 Filter 函式會傳回未包含 Match 做為子字串的陣列子集。

Compare

CompareMethod

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

傳回

String[]

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

例外狀況

ArgumentException

Source 是 Nothing 或不是一維陣列。

範例

這個範例示範如何使用 函 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	執行文字比較

另請參閱

• Replace(String, String, String, Int32, Int32, CompareMethod)
• ArgumentException
• 字串操作摘要