Função Filter

Observação: Desejamos fornecer o conteúdo da Ajuda mais recente no seu idioma da forma mais rápida possível. Esta página foi traduzida de forma automatizada e pode conter imprecisões ou erros gramaticais. Nosso objetivo é que este conteúdo seja útil para você. As informações foram úteis? Dê sua opinião no final desta página. Aqui está o artigo em inglês para facilitar a referência.

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.

Expanda suas habilidades no Office
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.

×