Table of contents
TOC
Recolher sumário
Expandir sumário

Função de filtroFilter Function

office 365 dev account|Última Atualização: 22/03/2018
|
2 Colaboradores

Descrição Retorna uma matriz baseada em zero que contém o subconjunto de uma matriz de cadeia de caracteres com base em um critério de filtro especificado. SintaxeFiltro ( sourcearray, correspondência ** [ **inclua [ compare ]] ) A sintaxe da função de filtro tem estesargumento nomeado:Description Returns a zero-based array containing subset of a string array based on a specified filter criteria. SyntaxFilter( sourcearray, match [ , include [ , compare ]] ) The Filter function syntax has thesenamed argument:

PartePartDescriçãoDescription
SourceArraysourcearrayNecessário. Matriz unidimensional de sequências de caracteres a ser pesquisado.Required. One-dimensional array of strings to be searched.
correspondênciamatchNecessário. Cadeia de caracteres a ser pesquisado.Required. String to search for.
incluirincludeOpcional. Valor booleano que indica se é necessário retornar subsequências que incluem ou excluem corresponder. Se incluir for True, o filtro retorna o subconjunto da matriz que contém a corresponder como uma subcadeia de caracteres. Se incluir for False, o filtro retorna o subconjunto da matriz que não contenha corresponder como uma subcadeia de caracteres.Optional. Boolean value indicating whether to return substrings that include or exclude match. If include is True, Filter returns the subset of the array that contains match as a substring. If include is False, Filter returns the subset of the array that does not contain match as a substring.
CompararcompareOpcional. Valor numérico indicando o tipo de condição de cadeia de caracteres a ser utilizada. Consulte a seção configurações para valores.Optional. Numeric value indicating the kind of string comparison to use. See Settings section for values.

Configurações O argumento compare pode ter os seguintes valores:Settings The compare argument can have the following values:

ConstanteConstantValorValueDescriçãoDescription
vbUseCompareOptionvbUseCompareOption-1-1Executa uma comparação usando a configuração da instrução da Option Compare.Performs a comparison using the setting of the Option Compare statement.
vbBinaryComparevbBinaryCompare00Executa uma comparação binária.Performs a binary comparison.
vbTextComparevbTextCompare11Executa uma comparação textual.Performs a textual comparison.
vbDatabaseComparevbDatabaseCompare22Somente no Microsoft Access. Executa uma comparação baseada nas informações do seu banco de dados.Microsoft Access only. Performs a comparison based on information in your database.

Comentários Se nenhuma correspondência de corresponder forem encontrada em sourcearray, o filtro retorna uma matriz vazia. Ocorrerá um erro se sourcearray é Nulo ou não é uma matriz unidimensional. A matriz retornada pela função filtro contém apenas elementos suficientes para conter o número de itens correspondentes.Remarks If no matches of match are found within sourcearray, Filter returns an empty array. An error occurs if sourcearray is Null or is not a one-dimensional array. The array returned by the Filter function contains only enough elements to contain the number of matched items.

© 2018 Microsoft