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 Corresponder 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, ao procurar o número de alguém em um catálogo telefônico, você está usando o nome da pessoa como o valor de pesquisa, mas o número de telefone é o valor que você deseja.

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, CORRESP localizará o maior valor que seja menor ou igual a lookup_value. Lookup_array devem ser colocados em ordem crescente: ...-2, -1, 0, 1, 2, ..., A-Z, false, true.

Se match_type for 0, CORRESP localizará o primeiro valor que seja exatamente igual a lookup_value. Lookup_array poderá estar em qualquer ordem.

Se match_type for -1, CORRESP localizará o menor valor que seja maior ou igual a lookup_value. Lookup_array devem ser colocados em ordem decrescente: true, false, Z-A, ... 2, 1, 0, -1, -2, ..., e assim por diante. Se match_type for omitido, será considerado 1.

Corresp retorna a posição do valor correspondido dentro de lookup_array, e 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"}.

CORRESP não distingue entre letras maiúsculas e minúsculas ao corresponder valores de texto.

Se a Correspondência não conseguir encontrar uma correspondência, ela retornará o valor de erro #N/D.

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.

Aplica-se a