Método XmlMappedRange.Find

  • Artigo

Localiza informações específicas em um XmlMappedRange controle e retorna um Range que representa a primeira célula onde essas informações se encontram.

Namespace:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel (em Microsoft.Office.Tools.Excel.dll)

Sintaxe

'Declaração
Function Find ( _
    What As Object, _
    After As Object, _
    LookIn As Object, _
    LookAt As Object, _
    SearchOrder As Object, _
    SearchDirection As XlSearchDirection, _
    MatchCase As Object, _
    MatchByte As Object, _
    SearchFormat As Object _
) As Range

Range Find(
    Object What,
    Object After,
    Object LookIn,
    Object LookAt,
    Object SearchOrder,
    XlSearchDirection SearchDirection,
    Object MatchCase,
    Object MatchByte,
    Object SearchFormat
)

Parâmetros

  • What
    Tipo: System.Object
    Os dados para pesquisar.Pode ser uma seqüência de caracteres ou qualquer tipo de dados do Excel de Microsoft Office.
  • After
    Tipo: System.Object
    A célula após o qual você deseja que a pesquisa comece.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é que o método dê a volta e chegue a essa célula.Se você não especificar esse argumento, a pesquisa começará após a célula no canto superior esquerdo do intervalo.
  • MatchCase
    Tipo: System.Object
    true Para fazer a pesquisa diferencia maiúsculas de minúsculas.O valor padrão é false.
  • MatchByte
    Tipo: System.Object
    Usado somente se você selecionou ou instalou o suporte a idiomas de byte duplo.truepara assegurar que os caracteres de byte duplo coincida somente caracteres de byte duplo; falsepara que os caracteres de dois bytes coincidam com seus equivalentes de byte único.

Valor de retorno

Tipo: Microsoft.Office.Interop.Excel.Range
A Range que representa a primeira célula onde as informações especificadas são encontradas.

Comentários

Esse método retorna nulluma referência nula (Nothing no Visual Basic) 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, SearchOrder, e MatchByte são salvas toda vez que você pode usar este método. Se você não especificar valores para esses argumentos, na próxima vez que você chamar o método os valores salvos serão usados. A definição desses 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 explicitamente esses argumentos toda vez que você usar esse método.

Você pode usar o FindNext e FindPrevious métodos para repetir a pesquisa.

Exemplos

O exemplo de código a seguir define o valor de um XmlMappedRange a seqüência de caracteres "Smith" e usa o Find, FindNext, e FindPrevious métodos para localizar a primeira célula com a seqüência de caracteres "Smith". Porque um XmlMappedRange sempre contém exatamente uma célula, a mesma célula encontra-se em cada caso. Este exemplo de código pressupõe que a planilha atual contém um XmlMappedRange chamado CustomerLastNameCell.

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

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

    // Use Find to get the range with "Smith".
    Excel.Range range1 = this.CustomerLastNameCell.Find("Smith",
        missing, missing, missing, missing, Excel.XlSearchDirection.xlNext,
        missing, missing, missing);
    string address1 = range1.get_Address(missing, missing,
        Excel.XlReferenceStyle.xlA1, missing, missing);
    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(missing, missing, 
        Excel.XlReferenceStyle.xlA1, missing, missing);
    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(missing, missing,
        Excel.XlReferenceStyle.xlA1, missing, missing);
    MessageBox.Show("FindPrevious method found the range: " + address3);
}

Segurança do .NET Framework

Consulte também

Referência

XmlMappedRange Interface

Namespace Microsoft.Office.Tools.Excel