Strings.Filter 方法 (Object , String, Boolean, CompareMethod)

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

命名空間： Microsoft.VisualBasic
組件： Microsoft.VisualBasic (在 microsoft.visualbasic.dll 中)

語法

'宣告
Public Shared Function Filter ( _
    Source As Object(), _
    Match As String, _
    <OptionalAttribute> Optional Include As Boolean = True, _
    <OptionalAttribute> Optional Compare As CompareMethod = CompareMethod.Binary _
) As String()
'用途
Dim Source As Object()
Dim Match As String
Dim Include As Boolean
Dim Compare As CompareMethod
Dim returnValue As String()

returnValue = Strings.Filter(Source, Match, Include, Compare)

public static string[] Filter (
    Object[] Source,
    string Match,
    [OptionalAttribute] bool Include,
    [OptionalAttribute] CompareMethod Compare
)

public:
static array<String^>^ Filter (
    array<Object^>^ Source, 
    String^ Match, 
    [OptionalAttribute] bool Include, 
    [OptionalAttribute] CompareMethod Compare
)

public static String[] Filter (
    Object[] Source, 
    String Match, 
    /** @attribute OptionalAttribute() */ boolean Include, 
    /** @attribute OptionalAttribute() */ CompareMethod Compare
)

public static function Filter (
    Source : Object[], 
    Match : String, 
    Include : boolean, 
    Compare : CompareMethod
) : String[]

參數

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

• Match
  必要項。要搜尋的字串。

• Include
  選擇項。Boolean 值，指出是否要傳回加入或排除 Match 的子字串。如果 Include 為 True，則 Filter 函式會傳回包含 Match 做為子字串的陣列子集。如果 Include 為 False，則 Filter 函式會傳回未包含 Match 做為子字串的陣列子集。

• Compare
  選擇項。數值，表示要使用的字串比較類型。請參閱值的「設定」。

傳回值

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

備註

如需詳細資訊，請參閱 Visual Basic 的主題 Filter 函式 (Visual Basic)。

如果在 Source 內找不到任何相符的 Match，則 Filter 函式會傳回空的陣列。如果 Source 設定為 Nothing 或者不是一維陣列，則會發生錯誤。

Filter 函式傳回的陣列只會包含容納相符項目數目所需的足夠元素。

Compare 引數可以具有下列的值。

範例

這個範例示範 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)

平台

Windows 98、 Windows 2000 SP4、 Windows CE、 Windows Millennium Edition、 Windows Mobile for Pocket PC、 Windows Mobile for Smartphone、 Windows Server 2003、 Windows XP Media Center Edition、 Windows XP Professional x64 Edition、 Windows XP SP2、 Windows XP Starter Edition

.NET Framework 並不支援各種平台的所有版本。如需支援平台版本的相關資訊，請參閱系統需求一節的內容。

版本資訊

.NET Framework

支援版本：2.0、1.1、1.0

.NET Compact Framework

支援版本：2.0、1.0

請參閱

參考

Strings 類別
Strings 成員
Microsoft.VisualBasic 命名空間
ArgumentException

其他資源

Filter 函式 (Visual Basic)
字串操作摘要
Replace 函式 (Visual Basic)