XmlMappedRange.Find Método

Definición

Espacio de nombres:

Microsoft.Office.Tools.Excel

Ensamblado:

Microsoft.Office.Tools.Excel.dll

Busca información específica en un control XmlMappedRange y devuelve un objeto Range que representa la primera celda en la que se encuentra esa información.

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

Datos que se van a buscar. Puede ser una cadena o cualquier tipo de datos de Microsoft Office Excel.

After

Object

Celda situada a continuación de la que se desea que comience la búsqueda. Corresponde a la posición de la celda activa cuando se realiza una búsqueda desde la interfaz de usuario. Tenga en cuenta que After debe ser una sola celda del rango. Recuerde que la búsqueda comienza a continuación de esta celda; no se busca en la celda especificada hasta que el método vuelve a buscar delante de ella. Si no especifica este argumento, la búsqueda se inicia a continuación de la celda situada en la esquina superior izquierda del rango.

LookIn

Object

Tipo de información.

LookAt

Object

Puede ser uno de los siguientes valores de XlLookAt: xlWhole o xlPart.

SearchOrder

Object

Puede ser uno de los siguientes valores de XlSearchOrder: xlByRows o xlByColumns.

SearchDirection

XlSearchDirection

Dirección de búsqueda. Puede ser uno de los siguientes XlSearchDirection valores: xlNext o xlPrevious.

MatchCase

Object

true para que en la búsqueda se distinga entre mayúsculas y minúsculas. El valor predeterminado es false.

MatchByte

Object

Solamente se utiliza si ha seleccionado o instalado la compatibilidad con idiomas de doble byte. true si las coincidencias con caracteres de doble byte sólo deben ser con caracteres de doble byte; false si las coincidencias con caracteres de doble byte van a ser con equivalentes de un solo byte.

SearchFormat

Object

Formato de la búsqueda.

Devoluciones

Range

Objeto Range que representa la primera celda en que se encuentra la información especificada.

Ejemplos

En el ejemplo de código siguiente se establece el valor de en XmlMappedRange la cadena "Smith" y, a continuación, se usan los Findmétodos , FindNexty FindPrevious para buscar la primera celda con la cadena "Smith". Dado que un XmlMappedRange elemento siempre contiene exactamente una celda, la misma celda se encuentra en cada caso. En este ejemplo de código se supone que la hoja de cálculo actual contiene un XmlMappedRange denominado 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

Comentarios

Este método devuelve null si no se encuentra ninguna coincidencia.

Este método no afecta a la selección ni a la celda activa.

La configuración de LookIn, LookAt, SearchOrdery MatchByte se guarda cada vez que se usa este método. Si no especifica valores para estos argumentos, la próxima vez que llame al método se usarán los valores guardados. Al establecer estos argumentos, se cambia la configuración del cuadro de diálogo Buscar y se cambia la configuración del cuadro de diálogo Buscar los valores guardados que se usan si se omiten los argumentos. Para evitar problemas, establezca estos argumentos explícitamente cada vez que use este método.

Puede usar los Microsoft.Office.Interop.Excel.Range.FindNext* métodos y FindPrevious para repetir la búsqueda.