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

Definição

Namespace:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

Find(String, String, Object) e FindB localizam uma cadeia de caracteres de texto dentro de uma segunda cadeia de caracteres de texto e retornam o número da posição inicial da primeira cadeia de texto do primeiro caractere da segunda cadeia de texto.

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

Public Function FindB (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 que contém o texto que você deseja localizar.

Arg3

Object

Núm_inicial - especifica o caractere a partir do qual a pesquisa será iniciada. O primeiro caractere no_texto é o caractere número 1. Se for omitido, núm_inicial será considerado como 1.

Retornos

Double

Comentários

Importante: Find(String, String, Object) destina-se ao uso com linguagens que usam o conjunto de caracteres de byte único (SBCS), enquanto o FindB destina-se a ser usado com linguagens 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:

• Find(String, String, Object) 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 FindB 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 FindB conta cada caractere como 1.

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

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

Se find_text for "" (texto vazio), Find(String, String, Object) corresponderá ao primeiro caractere na cadeia de caracteres de pesquisa (ou seja, o caractere numerado start_num ou 1).

Texto_procurado não pode conter nenhum caractere curinga.

Se find_text não aparecer no within_text Find(String, String, Object) e o FindB retornar o #VALUE! valor de erro.

Se start_num não for maior que zero Find(String, String, Object) e o FindB retornar o #VALUE! valor de erro.

Se start_num for maior que o comprimento de within_text Find(String, String, Object) e o FindB retornar o #VALUE! valor de erro.

Use núm_inicial para ignorar um número de caracteres especificado. Usando Find(String, String, Object) 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. Find(String, String, Object) começa com o caractere 8, encontra find_text no próximo caractere e retorna o número 9. Find(String, String, Object) 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.