Compartilhar via

Método XmlMappedRange.Find

  • Artigo

Informações específicas de localiza em um controle de XmlMappedRange , e em retorna Range que representa a primeira célula onde essa informação é encontrada.

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 procurar por.Pode ser uma cadeia de caracteres ou qualquer tipo de dados do Microsoft Office Excel.
  • After
    Tipo: System.Object
    A célula após o qual você deseja a pesquisa para iniciar.Isso corresponde a posição da célula ativa quando uma pesquisa é feita da interface do usuário.Observe que After deve ser uma única célula no intervalo.Lembre-se de que a pesquisa começa após essa célula; a célula específica não é pesquisada até que a quebra automática do método de volta ao redor a essa célula.Se você não especificar esse argumento, a pesquisa após a célula no canto superior esquerdo do intervalo.
  • MatchCase
    Tipo: System.Object
    true para fazer a pesquisa maiúsculas de minúsculas.O valor padrão é false.
  • MatchByte
    Tipo: System.Object
    Usado somente se você selecionou instalado ou suporte de linguagem de dois bytes.true para ter caracteres de byte duplo corresponde apenas caracteres de byte duplo; false para que caracteres de byte duplo corresponder seus equivalentes de byte único.

Valor de retorno

Tipo: Microsoft.Office.Interop.Excel.Range
Range que representa a primeira célula onde informações especificada for encontrada.

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 célula ativo.

As configurações para LookIn, LookAt, SearchOrder, e MatchByte são salvas cada vez que você usa esse método. Se você não especificar valores para esses argumentos, a próxima vez que você chamar o método valores salvos são usados. Definir esses argumentos altera as configurações na caixa de diálogo localizar, e modificar as configurações na caixa de diálogo localizar altera os valores salvos que são usados se você omitir argumentos. Para evitar problemas, definir esses argumentos explicitamente cada vez que você usa esse método.

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

Exemplos

O exemplo de código a seguir define o valor de XmlMappedRange a cadeia de caracteres “Smith”, e usa o Find, FindNext, e métodos de FindPrevious para encontrar a primeira célula com a cadeia de caracteres “Smith”. Porque XmlMappedRange sempre contém exatamente de uma célula, a mesma célula é encontrada em cada caso. Este exemplo de código a seguir pressupõe que a planilha atual contiver 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",
        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);
}

Segurança do .NET Framework

Consulte também

Referência

XmlMappedRange Interface

Namespace Microsoft.Office.Tools.Excel