Strings.Filter 方法

定义

命名空间:: Microsoft.VisualBasic

程序集:: Microsoft.VisualBasic.Core.dll

程序集:: Microsoft.VisualBasic.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

返回一个从零开始的数组，该数组包含基于指定筛选条件的 String 数组子集。

重载

名称	说明
Filter(Object[], String, Boolean, CompareMethod)	返回一个从零开始的数组，该数组包含基于指定筛选条件的 `String` 数组子集。
Filter(String[], String, Boolean, CompareMethod)	返回一个从零开始的数组，该数组包含基于指定筛选条件的 `String` 数组子集。

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

Source:: Strings.vb

Source:: Strings.vb

Source:: Strings.vb

Source:: Strings.vb

Source:: 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

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)

注解

如果在其中Match找不到匹配项Source，该Filter函数将返回一个空数组。如果 Source 设置为 Nothing 或不是一维数组，则会发生错误。

函数返回的 Filter 数组仅包含足以包含匹配项数的元素。

该 Compare 参数可以具有以下值。

恒定	Description
`CompareMethod.Binary`	执行二进制比较
`CompareMethod.Text`	执行文本比较

另请参阅

适用于

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

Source:: Strings.vb

Source:: Strings.vb

Source:: Strings.vb

Source:: Strings.vb

Source:: 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

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)

注解

如果在其中Match找不到匹配项Source，该Filter函数将返回一个空数组。如果 Source 设置为 Nothing 或不是一维数组，则会发生错误。

函数返回的 Filter 数组仅包含足以包含匹配项数的元素。

该 Compare 参数可以具有以下值。

恒定	Description
`CompareMethod.Binary`	执行二进制比较
`CompareMethod.Text`	执行文本比较

另请参阅

适用于

反馈

此页面是否有帮助？