Função Filter

Importante :  Este artigo foi traduzido por um sistema de tradução automática, leia o aviso de isenção de responsabilidade. Para sua referência, veja a versão em inglês deste artigo aqui.

Retorna uma matriz com base em zero contendo subconjunto de uma matriz de cadeia de caracteres com base em um critério de filtro especificado.

Sintaxe

Filtro ( sourcearray corresponder [inclua ] [Comparar ] )

A sintaxe da função de filtro possui os seguintes argumentos:

Argumento

Descrição

SourceArray

Necessário. Matriz unidimensional de cadeias de caracteres a ser pesquisado.

CORRESP

Necessário. Cadeia de caracteres para pesquisar.

incluir

Opcional. Valor booliano que indica se retornarão substrings que incluem ou excluir correspondem. Se incluir for verdadeira, o filtro retorna o subconjunto da matriz que contém a corresponder como uma subcadeia de caracteres. Se incluir for Falso, o filtro retorna o subconjunto da matriz que não contenha corresponder como uma subcadeia de caracteres.

Comparar

Opcional. Valor numérico indicando o tipo de comparação de cadeia de caracteres para usar. Consulte a seção configurações para os valores.


Configurações

O argumento compare pode ter os seguintes valores:

Constante

Valor

Descrição

vbUseCompareOption

– 1

Executa uma comparação usando a configuração da instrução Option Compare .

vbBinaryCompare

0

Executa uma comparação binária.

vbTextCompare

1

Executa uma comparação textual.

vbDatabaseCompare

2

Microsoft Office Access 2007 somente. Executa uma comparação com base nas informações no banco de dados.


Comentários

Se nenhuma correspondência de corresponder forem encontrada em sourcearray, o filtro retorna uma matriz vazia. Um erro ocorre se sourcearray é Nulo ou não é uma matriz unidimensional.

A matriz retornada pela função Filter contém apenas o número de elementos suficientes para conter o número de itens correspondentes.

Observação : Aviso de Isenção de Tradução Automática: Este artigo foi traduzido por computador, sem intervenção humana. A Microsoft oferece essas traduções automáticas para ajudar as pessoas que não falam inglês a aproveitar os textos escritos sobre produtos, serviços e tecnologias da Microsoft. Como este artigo foi traduzido automaticamente, é possível que contenha erros de vocabulário, sintaxe ou gramática.

Expanda suas habilidades
Explore o treinamento
Obtenha novos recursos primeiro
Ingressar no Office Insider

Essas informações foram úteis?

Obrigado por seus comentários!

Agradecemos pelos seus comentários! Parece que pode ser útil conectar você a um de nossos agentes de suporte do Office.

×