Método WorksheetFunction.Search (Excel)

Pesquise e PesquiseB localize uma cadeia de caracteres de texto dentro de uma segunda cadeia de caracteres de texto e retorne o número da posição inicial da primeira cadeia de texto do primeiro caractere da segunda cadeia de texto.

Sintaxe

expressão. Pesquisa (Arg1, Arg2, Arg3)

Expressão Uma variável que representa um objeto WorksheetFunction .

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
Arg1	Obrigatório	String	Find_text - o texto que você deseja encontrar.
Arg2	Obrigatório	String	No_texto - o texto em que você deseja localizar o texto_procurado.
Arg3	Opcional	Variantes	Núm_inicial - o número do caractere em no_texto em que você deseja iniciar a pesquisa.

Valor de retorno

Double

Comentários

A pesquisa destina-se ao uso com idiomas que usam o conjunto de caracteres de byte único (SBCS), enquanto o SearchB destina-se a ser usado com idiomas que usam o DBCS (conjunto de caracteres de byte duplo). A configuração de idioma padrão no computador afeta o valor de retorno da seguinte forma:

• A pesquisa sempre conta cada caractere, seja byte único ou byte duplo, como 1, não importa qual seja a configuração padrão do idioma.

• O SearchB conta cada caractere de byte duplo como 2 quando você habilita a edição de um idioma que dá suporte ao DBCS e, em seguida, define-o como o idioma padrão. Caso contrário, o SearchB conta cada caractere como 1.

• Os idiomas com suporte para DBCS são: japonês, chinês (simplificado), chinês (tradicional) e coreano.

Use Pesquisa e SearchB para determinar o local de uma cadeia de caracteres ou de texto em outra cadeia de caracteres de texto para que você possa usar as funções Mid e MidB ou Replace e ReplaceB para alterar o texto.

A pesquisa e o SearchB não são sensíveis a casos. Se você quiser fazer uma pesquisa sensível a casos, poderá usar Localizar e LocalizarB.

Use os caracteres curinga, o ponto de interrogação (?) e o asterisco (*), em find_text. 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.

Se texto_procurado não for localizado, o valor de erro #VALOR! será retornado.

Se núm_inicial for omitido, será equivalente a 1.

Se núm_inicial não for maior do que 0 ou for maior do que o comprimento de no_texto, o valor de erro #VALOR! será retornado.

Use núm_inicial para ignorar um número de caracteres especificado. Usando o Search como exemplo, suponha que você esteja trabalhando com a cadeia de caracteres AYF0093.YoungMensApparelde texto . Para localizar o número do primeiro "Y" na parte descritiva da cadeia de caracteres de texto, defina start_num igual a 8 para que a parte de número de série do texto não seja pesquisada. A pesquisa começa com o caractere 8, encontra find_text no próximo caractere e retorna o número 9.

A pesquisa sempre retorna o número de caracteres desde o início do within_text, contando os caracteres que você ignora se start_num for maior que 1.

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.