WorksheetFunction.Match(Object, Object, Object) Método

Definição

Namespace:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

Retorna a posição relativa de um item em uma matriz que corresponda a um valor especificado em uma ordem especificada. Use Match em vez de uma das Lookup(Object, Object, Object) funções quando precisar da posição de um item em um intervalo em vez do item em si.

public double Match (object Arg1, object Arg2, object Arg3);

Public Function Match (Arg1 As Object, Arg2 As Object, Optional Arg3 As Object) As Double

Parâmetros

Arg1

Object

Lookup_value - o valor usado para localizar o valor desejado em uma tabela.

Arg2

Object

Lookup_array - um intervalo contíguo de células que contém valores de pesquisa possíveis. Lookup_array deve ser uma matriz ou uma referência de matriz.

Arg3

Object

Match_type - o número -1, 0 ou 1. Match_type especifica como o Microsoft Excel corresponde a lookup_value com valores em lookup_array.

Retornos

Double

Comentários

Lookup_value é o valor que você deseja corresponder em lookup_array. Por exemplo, quando você pesquisa o número de alguém em uma lista telefônica, você está usando o nome da pessoa como o valor de pesquisa, mas o número de telefone é o valor desejado.

Lookup_value pode ser um valor (número, texto ou valor lógico) ou uma referência de célula para um número, texto ou valor lógico.

Se match_type for 1, Match encontrará o maior valor menor ou igual a lookup_value. Lookup_array deve ser colocado em ordem crescente: ...-2, -1, 0, 1, 2, ..., A-Z, false, true.

Se match_type for 0, Match encontrará o primeiro valor exatamente igual a lookup_value. Lookup_array poderá estar em qualquer ordem.

Se match_type for -1, Match encontrará o menor valor maior ou igual a lookup_value. Lookup_array deve ser colocado em ordem decrescente: true, false, Z-A, ... 2, 1, 0, -1, -2, ..., e assim por diante. Se match_type for omitido, presume-se que seja 1.

Match retorna a posição do valor correspondente dentro de lookup_array, não o valor em si. Por exemplo, MATCH("b",{"a","b","c"},0) retorna 2, a posição relativa de "b" na matriz {"a","b","c"}.

A correspondência não distingue entre letras maiúsculas e minúsculas ao corresponder valores de texto.

Se Match não tiver êxito em encontrar uma correspondência, ela retornará o valor de erro #N/A.

Se match_type for 0 e se lookup_value for texto, então você poderá usar os caracteres curinga, o ponto de interrogação (?) e o asterisco (*), no lookup_value. Um ponto de interrogação corresponde a qualquer caractere único; um asterisco corresponde a qualquer sequência de caracteres. Se você quiser localizar um ponto de interrogação ou um asterisco, digite um til (~) antes do caractere.