Strings.Filter Método

Definição

Espaço de Nomes:
Microsoft.VisualBasic
Assemblagem:
Microsoft.VisualBasic.dll

Devolve um array baseado em zeros contendo um subconjunto de um String array com base em critérios de filtro especificados.

Sobrecargas

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

Devolve um array baseado em zeros contendo um subconjunto de um String array com base em critérios de filtro especificados.
Filter(String[], String, Boolean, CompareMethod)

Devolve um array baseado em zeros contendo um subconjunto de um String array com base em critérios de filtro especificados.

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

Devolve um array baseado em zeros contendo um subconjunto de um String array com base em critérios de filtro especificados.

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()

Parâmetros

Source
Object[]

Required. Matriz unidimensional de cadeias a procurar.

Match
String

Required. Cadeia a procurar.

Include
Boolean

Optional. Boolean valor que indica se deves devolver subcadeias que incluem ou excluem Match. Se Include for , a Filter função devolve o subconjunto do array que contém MatchTruecomo substring. Se Include for , a Filter função devolve o subconjunto do array que não contém MatchFalsecomo substring.

Compare
CompareMethod

Optional. Valor numérico que indica o tipo de comparação de cadeias a utilizar. Veja "Definições" para os valores.

Devoluções

String[]

Um array baseado em zero contendo um subconjunto de um String array com base em critérios de filtro especificados.

Exceções

ArgumentException

Source é Nothing ou não é um array unidimensional.

Exemplos

Este exemplo demonstra a utilização da Filter função.

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)

Observações

Se não forem encontradas correspondências de Match dentro de Source, a Filter função devolve um array vazio. Ocorre um erro se Source for definido como Nothing ou não for um array unidimensional.

O array devolvido pela Filter função contém apenas elementos suficientes para conter o número de itens correspondentes.

O Compare argumento pode ter os seguintes valores.

Constante Description
CompareMethod.Binary Realiza uma comparação binária
CompareMethod.Text Realiza uma comparação textual

Ver também

Aplica-se a

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

Devolve um array baseado em zeros contendo um subconjunto de um String array com base em critérios de filtro especificados.

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()

Parâmetros

Source
String[]

Required. Matriz unidimensional de cadeias a procurar.

Match
String

Required. Cadeia a procurar.

Include
Boolean

Optional. Boolean valor que indica se deves devolver subcadeias que incluem ou excluem Match. Se Include for , a Filter função devolve o subconjunto do array que contém MatchTruecomo substring. Se Include for , a Filter função devolve o subconjunto do array que não contém MatchFalsecomo substring.

Compare
CompareMethod

Optional. Valor numérico que indica o tipo de comparação de cadeias a utilizar. Veja "Definições" para os valores.

Devoluções

String[]

Um array baseado em zero contendo um subconjunto de um String array com base em critérios de filtro especificados.

Exceções

ArgumentException

Source é Nothing ou não é um array unidimensional.

Exemplos

Este exemplo demonstra a utilização da Filter função.

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)

Observações

Se não forem encontradas correspondências de Match dentro de Source, a Filter função devolve um array vazio. Ocorre um erro se Source for definido como Nothing ou não for um array unidimensional.

O array devolvido pela Filter função contém apenas elementos suficientes para conter o número de itens correspondentes.

O Compare argumento pode ter os seguintes valores.

Constante Description
CompareMethod.Binary Realiza uma comparação binária
CompareMethod.Text Realiza uma comparação textual

Ver também

Aplica-se a