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

Esta página é útil?

Algum comentário adicional?

Os comentários serão enviados à Microsoft: quando você pressionar o botão Enviar, seus comentários serão usados para aprimorar os produtos e os serviços da Microsoft. Política de Privacidade.

Definição

Namespace:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

As funções LOCALIZAR e LOCALIZARB localizam uma sequência de caracteres de texto em outra sequência e retornam o número da posição inicial da primeira sequência de caracteres de texto do primeiro caractere da segunda sequência de caracteres de texto.

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

Public Function SearchB (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:a pesquisa destina-se a ser usada com idiomas que usam o conjunto de caracteres de byte único (SBCS), enquanto que se destina ao uso com idiomas que usam o conjunto de caracteres de byte duplo SearchB(String, String, Object) (DBCS). A configuração de idioma padrão em seu computador afeta o valor de retorno da seguintemaneira: a pesquisa sempre conta cada caractere, seja de byte único ou de byte 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ê habilitar a edição de um idioma que dá suporte a DBCS e defini-lo 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 Pesquisar e para determinar o local de um caractere ou cadeia de caracteres de texto em outra cadeia de caracteres de texto para que você possa usar o MID e MIDB ou funções para alterar SearchB(String, String, Object) o Replace(String, Double, Double, String) ReplaceB(String, Double, Double, String) texto.

Pesquise SearchB(String, String, Object) e não sejam sensíveis a minúsculas. Se você quiser fazer uma pesquisa de caso sensível, você pode 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 asterisco real, 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ê está 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, find_text no próximo caractere e retorna o número 9. A pesquisa sempre retorna o número de caracteres do início do within_text, contando os caracteres que você ignora se start_num for maior que 1.