Strings.Filter Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Retorna uma matriz baseada em zero que contém um subconjunto de uma String matriz com base nos critérios de filtro especificados.
Sobrecargas
| Nome | Description |
|---|---|
| Filter(Object[], String, Boolean, CompareMethod) |
Retorna uma matriz baseada em zero que contém um subconjunto de uma |
| Filter(String[], String, Boolean, CompareMethod) |
Retorna uma matriz baseada em zero que contém um subconjunto de uma |
Filter(Object[], String, Boolean, CompareMethod)
Retorna uma matriz baseada em zero que contém um subconjunto de uma String matriz com base nos 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 de caracteres a serem pesquisadas.
- Match
- String
Required. Cadeia de caracteres para pesquisar.
- Include
- Boolean
Optional.
Boolean valor que indica se as subcadeias de caracteres que incluem ou excluem Match. Se Include for True, a Filter função retornará o subconjunto da matriz que contém Match como uma subcadeia de caracteres. Se Include for False, a Filter função retornará o subconjunto da matriz que não contém Match como uma subcadeia de caracteres.
- Compare
- CompareMethod
Optional. Valor numérico que indica o tipo de comparação de cadeia de caracteres a ser usada. Consulte "Configurações" para obter valores.
Retornos
Uma matriz baseada em zero que contém um subconjunto de uma String matriz com base nos critérios de filtro especificados.
Exceções
Source é Nothing ou não é uma matriz unidimensional.
Exemplos
Este exemplo demonstra o uso 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)
Comentários
Se nenhuma correspondência for Match encontrada dentro Source, a Filter função retornará uma matriz vazia. Ocorrerá um erro se Source estiver definido Nothing como ou não for uma matriz unidimensional.
A matriz retornada 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 | Descrição |
|---|---|
CompareMethod.Binary |
Executa uma comparação binária |
CompareMethod.Text |
Executa uma comparação textual |
Confira também
- Replace(String, String, String, Int32, Int32, CompareMethod)
- ArgumentException
- Resumo da manipulação de cadeia de caracteres
Aplica-se a
Filter(String[], String, Boolean, CompareMethod)
Retorna uma matriz baseada em zero que contém um subconjunto de uma String matriz com base nos 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 de caracteres a serem pesquisadas.
- Match
- String
Required. Cadeia de caracteres para pesquisar.
- Include
- Boolean
Optional.
Boolean valor que indica se as subcadeias de caracteres que incluem ou excluem Match. Se Include for True, a Filter função retornará o subconjunto da matriz que contém Match como uma subcadeia de caracteres. Se Include for False, a Filter função retornará o subconjunto da matriz que não contém Match como uma subcadeia de caracteres.
- Compare
- CompareMethod
Optional. Valor numérico que indica o tipo de comparação de cadeia de caracteres a ser usada. Consulte "Configurações" para obter valores.
Retornos
Uma matriz baseada em zero que contém um subconjunto de uma String matriz com base nos critérios de filtro especificados.
Exceções
Source é Nothing ou não é uma matriz unidimensional.
Exemplos
Este exemplo demonstra o uso 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)
Comentários
Se nenhuma correspondência for Match encontrada dentro Source, a Filter função retornará uma matriz vazia. Ocorrerá um erro se Source estiver definido Nothing como ou não for uma matriz unidimensional.
A matriz retornada 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 | Descrição |
|---|---|
CompareMethod.Binary |
Executa uma comparação binária |
CompareMethod.Text |
Executa uma comparação textual |
Confira também
- Replace(String, String, String, Int32, Int32, CompareMethod)
- ArgumentException
- Resumo da manipulação de cadeia de caracteres