Strings.Filter 方法

定義

命名空間:
Microsoft.VisualBasic
組件:
Microsoft.VisualBasic.dll

回傳一個以零為基礎的陣列，包含根據指定濾波條件的陣列子 String 集。

多載

名稱 Description
Filter(Object[], String, Boolean, CompareMethod)

回傳一個以零為基礎的陣列，包含根據指定濾波條件的陣列子 String 集。
Filter(String[], String, Boolean, CompareMethod)

回傳一個以零為基礎的陣列，包含根據指定濾波條件的陣列子 String 集。

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

回傳一個以零為基礎的陣列，包含根據指定濾波條件的陣列子 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

Optional. Boolean 值表示是否回傳包含或排除 Match的子串。 若 Include 為 ， True函 Filter 式回傳包含 Match 子串的陣列子集。 若 Include 為 ， False函 Filter 式回傳不包含 Match 子字串的陣列子集。

Compare
CompareMethod

Optional. 數值表示應使用的字串比較類型。 數值請參見「設定」。

傳回

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 進行文本比較

另請參閱

適用於

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

回傳一個以零為基礎的陣列，包含根據指定濾波條件的陣列子 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

Optional. Boolean 值表示是否回傳包含或排除 Match的子串。 若 Include 為 ， True函 Filter 式回傳包含 Match 子串的陣列子集。 若 Include 為 ， False函 Filter 式回傳不包含 Match 子字串的陣列子集。

Compare
CompareMethod

Optional. 數值表示應使用的字串比較類型。 數值請參見「設定」。

傳回

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 進行文本比較

另請參閱

適用於