WorksheetFunction.Search(String, String, Object) Método

Definição

Namespace:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

Pesquisa e SearchB(String, String, Object) 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.

public double Search (string Arg1, string Arg2, object Arg3);

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

Parâmetros

Arg1

String

Texto_procurado - o texto que você deseja localizar.

Arg2

String

No_texto - o texto em que você deseja localizar o texto_procurado.

Arg3

Object

Núm_inicial - o número do caractere em no_texto em que você deseja iniciar a pesquisa.

Retornos

Double

Comentários

Importante: Pesquisa destina-se ao uso com linguagens que usam o conjunto de caracteres de byte único (SBCS), enquanto SearchB(String, String, Object) destina-se a ser usado com linguagens que usam o DBCS (conjunto de caracteres de byte duplo). A configuração de idioma padrão em seu computador afeta o valor retornado da seguinte maneira: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. SearchB(String, String, Object) conta cada caractere de byte duplo como 2 quando você habilitou a edição de um idioma que dá suporte ao DBCS e, em seguida, define-o como o idioma padrão. Caso contrário, SearchB(String, String, Object) 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(String, String, Object) para determinar o local de uma cadeia de caracteres ou de texto dentro de outra cadeia de caracteres de texto para que você possa usar o MID e MIDB ou Replace(String, Double, Double, String) e ReplaceB(String, Double, Double, String) funções para alterar o texto.

Pesquisa e SearchB(String, String, Object) não são sensíveis a casos. Se você quiser fazer uma pesquisa confidencial de caso, poderá usar Find(String, String, Object) e FindB(String, String, Object).

É possível usar os caracteres curinga ponto de interrogação (?) e asterisco (*) em texto_procurado. 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 Pesquisa como exemplo, suponha que você esteja trabalhando com a cadeia de caracteres de texto "AYF0093. YoungMensApparel". Para localizar o número do primeiro "R" na parte descritiva da sequência de caracteres de texto, defina núm_inicial como 8 para que a parte do texto relativa ao número de série não seja localizada. Pesquisa começa com o caractere 8, encontra find_text no próximo caractere e retorna o número 9. 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.