XmlMappedRange.Find Método

Referência

Definição

Namespace:: Microsoft.Office.Tools.Excel

Assembly:: Microsoft.Office.Tools.Excel.dll

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.

Localiza informações específicas em um controle XmlMappedRange e retorna um Range, que representa a primeira célula na qual essas informações estão localizadas.

public Microsoft.Office.Interop.Excel.Range Find (object What, object After, object LookIn, object LookAt, object SearchOrder, Microsoft.Office.Interop.Excel.XlSearchDirection SearchDirection = Microsoft.Office.Interop.Excel.XlSearchDirection.xlNext, object MatchCase, object MatchByte, object SearchFormat);

abstract member Find : obj * obj * obj * obj * obj * Microsoft.Office.Interop.Excel.XlSearchDirection * obj * obj * obj -> Microsoft.Office.Interop.Excel.Range

Public Function Find (What As Object, Optional After As Object, Optional LookIn As Object, Optional LookAt As Object, Optional SearchOrder As Object, Optional SearchDirection As XlSearchDirection = Microsoft.Office.Interop.Excel.XlSearchDirection.xlNext, Optional MatchCase As Object, Optional MatchByte As Object, Optional SearchFormat As Object) As Range

Parâmetros

What: Object

Os dados a serem pesquisados. Pode ser uma cadeia de caracteres ou qualquer tipo de dados do Microsoft Office Excel.

After: Object

A célula depois da qual você deseja que a pesquisa seja iniciada. Isso corresponde à posição da célula ativa quando uma pesquisa é feita a partir da interface do usuário. Observe que After deve ser uma única célula no intervalo. Lembre-se de que a pesquisa começa depois desta célula; a célula especificada não é pesquisada até o método voltar a encapsulá-la. Se você não especificar esse argumento, a pesquisa começará após a célula do canto superior esquerdo do intervalo.

LookIn: Object

O tipo de informação.

LookAt: Object

Pode ser um dos seguintes valores de XlLookAt: xlWhole ou xlPart.

SearchOrder: Object

Pode ser um dos seguintes valores de XlSearchOrder: xlByRows ou xlByColumns.

SearchDirection: XlSearchDirection

A direção da pesquisa. Pode ser um dos seguintes XlSearchDirection valores: xlNext ou xlPrevious.

MatchCase: Object

true para fazer com que a pesquisa diferencie maiúsculas de minúsculas. O valor padrão é false.

MatchByte: Object

Usado somente se você tiver selecionado ou instalado o suporte ao idioma de byte duplo. true para ter caracteres de byte duplo correspondentes apenas a caracteres de byte duplo; false para ter caracteres de byte duplo correspondentes a equivalentes de byte único.

SearchFormat: Object

O formato da pesquisa.

Retornos

Range

Um Range que representa a primeira célula na qual a informação especificada é encontrada.

Exemplos

O exemplo de código a seguir define o valor de um XmlMappedRange para a cadeia de caracteres "Smith" e, em seguida, usa os Findmétodos , FindNexte FindPrevious para localizar a primeira célula com a cadeia de caracteres "Smith". Como um XmlMappedRange sempre contém exatamente uma célula, a mesma célula é encontrada em cada caso. Este exemplo de código pressupõe que a planilha atual contenha um XmlMappedRange chamado CustomerLastNameCell.

private void FindSmith()
{
    this.CustomerLastNameCell.Value2 = "Smith";

    // Use Find to get the range with "Smith".
    Excel.Range range1 = this.CustomerLastNameCell.Find("Smith",
        Excel.XlSearchDirection.xlNext);
    string address1 = range1.get_Address(missing, missing,
        Excel.XlReferenceStyle.xlA1);
    MessageBox.Show("Find method found the range: " + address1);

    // Use FindNext to get the range with "Smith".
    Excel.Range range2 = this.CustomerLastNameCell.FindNext(range1);
    string address2 = range2.get_Address(
        Excel.XlReferenceStyle.xlA1);
    MessageBox.Show("FindNext method found the range: " + address2);

    // Use FindPrevious to get the range with "Smith".
    Excel.Range range3 = this.CustomerLastNameCell.FindPrevious(range2);
    string address3 = range3.get_Address(
        Excel.XlReferenceStyle.xlA1);
    MessageBox.Show("FindPrevious method found the range: " + address3);
}

Private Sub FindSmith()
    Me.CustomerLastNameCell.Value2 = "Smith"

    ' Use Find to get the range with "Smith".
    Dim range1 As Excel.Range = Me.CustomerLastNameCell.Find( _
        "Smith", SearchDirection:=Excel.XlSearchDirection.xlNext)
    Dim address1 As String = range1.Address(ReferenceStyle:=Excel.XlReferenceStyle.xlA1)
    MsgBox("Find method found the range: " & address1)

    ' Use FindNext to get the range with "Smith".
    Dim range2 As Excel.Range = Me.CustomerLastNameCell.FindNext(range1)
    Dim address2 As String = range2.Address(ReferenceStyle:=Excel.XlReferenceStyle.xlA1)
    MsgBox("FindNext method found the range: " & address2)

    ' Use FindPrevious to get the range with "Smith".
    Dim range3 As Excel.Range = Me.CustomerLastNameCell.FindPrevious(range2)
    Dim address3 As String = range3.Address(ReferenceStyle:=Excel.XlReferenceStyle.xlA1)
    MsgBox("FindPrevious method found the range: " & address3)
End Sub

Comentários

Esse método retornará null se nenhuma correspondência for encontrada.

Este método não afeta a seleção ou a célula ativa.

As configurações de LookIn, LookAt, SearchOrdere MatchByte são salvas sempre que você usa esse método. Se você não especificar valores para esses argumentos, na próxima vez que chamar o método, os valores salvos serão usados. Definir esses argumentos altera as configurações na caixa de diálogo Localizar e alterar as configurações na caixa de diálogo Localizar altera os valores salvos que são usados se você omitir os argumentos. Para evitar problemas, defina estes argumentos explicitamente sempre que usar esse método.

Você pode usar os Microsoft.Office.Interop.Excel.Range.FindNext* métodos e FindPrevious para repetir a pesquisa.

Aplica-se a