WorksheetFunction.Search(String, String, Object) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Pesquise e SearchB(String, String, Object) localize uma cadeia de texto dentro de uma segunda cadeia 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 DoubleParâ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
Comentários
Importante: A pesquisa destina-se ao uso com idiomas que usam o conjunto de caracteres de byte único (SBCS), enquanto SearchB(String, String, Object) é destinada ao uso com idiomas que usam o conjunto de caracteres de byte duplo (DBCS). A configuração de idioma padrão no computador afeta o valor de retorno da seguinte maneira:A pesquisa sempre conta cada caractere, seja de byte único ou duplo, como 1, independentemente da configuração de idioma padrão. SearchB(String, String, Object) conta cada caractere de byte duplo como 2 quando você habilita a edição de um idioma compatível com DBCS e, em seguida, o define como 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 Pesquisar e SearchB(String, String, Object) para determinar o local de um caractere ou cadeia de texto dentro de outra cadeia de texto para que você possa usar as funções MID e MIDB ou Replace(String, Double, Double, String) e para ReplaceB(String, Double, Double, String) alterar o texto.
Pesquisar e SearchB(String, String, Object) não diferenciam maiúsculas de minúsculas. Se você quiser fazer uma pesquisa que diferencia maiúsculas de minúsculas, 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 a 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. A pesquisa começa com o caractere 8, localiza 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 de within_text, contando os caracteres ignorados se start_num for maior que 1.