Strings.Filter Метод

Определение

Пространство имен:: Microsoft.VisualBasic

Сборка:: Microsoft.VisualBasic.Core.dll

Сборка:: Microsoft.VisualBasic.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Возвращает отсчитываемый от нуля массив, содержащий подмножество массива String на основе указанных критериев фильтра.

Перегрузки

Имя	Описание
Filter(Object[], String, Boolean, CompareMethod)	Возвращает отсчитываемый от нуля массив, содержащий подмножество массива `String` на основе указанных критериев фильтра.
Filter(String[], String, Boolean, CompareMethod)	Возвращает отсчитываемый от нуля массив, содержащий подмножество массива `String` на основе указанных критериев фильтра.

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

Исходный код:: Strings.vb

Исходный код:: Strings.vb

Исходный код:: Strings.vb

Исходный код:: Strings.vb

Исходный код:: Strings.vb

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)

Исходный код:: Strings.vb

Исходный код:: Strings.vb

Исходный код:: Strings.vb

Исходный код:: Strings.vb

Исходный код:: Strings.vb

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

Возвращаемое значение

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)

См. также раздел

Применяется к

Обратная связь

Были ли сведения на этой странице полезными?

Strings.Filter Метод

Определение

Перегрузки

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

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

См. также раздел

Применяется к

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

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

См. также раздел

Применяется к