NamedRange.Find Método

Referencia

Definición

Espacio de nombres:: Microsoft.Office.Tools.Excel

Ensamblado:: Microsoft.Office.Tools.Excel.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Busca información específica en el control NamedRange y devuelve un objeto Range que representa la primera celda en la que se encuentra dicha 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

Es true para que en la búsqueda se distinga mayúsculas de 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 la que se encuentra la información.

Ejemplos

En el ejemplo de código siguiente se usa el Find método para buscar la primera celda con el valor Seashell de un NamedRange control . A continuación, en el ejemplo se usan los FindNext métodos y FindPrevious para buscar la celda siguiente con el valor Seashell y, a continuación, volver a la celda original. Por último, en el ejemplo se usa el Cut método para cortar el contenido de la primera celda con el valor Seashell y pegarlo en la celda B1.

Este ejemplo es para una personalización de nivel de documento.

private void FindValue()
{
    this.Range["A1"].Value2 = "Barnacle";
    this.Range["A2"].Value2 = "Seashell";
    this.Range["A3"].Value2 = "Star Fish";
    this.Range["A4"].Value2 = "Seashell";
    this.Range["A5"].Value2 = "Clam Shell";

    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1", "A5"],
        "namedRange1");

    // Find the first occurrence of "Seashell".
    Excel.Range Range1 = namedRange1.Find("Seashell",
        Excel.XlLookAt.xlWhole, Excel.XlSearchOrder.xlByColumns,
        Microsoft.Office.Interop.Excel.XlSearchDirection.xlNext,
        false);

    // Find the next occurrence of "Seashell".
    Range1 = namedRange1.FindNext(Range1);

    // Return to the first occurrence of "Seashell".
    Range1 = namedRange1.FindPrevious(Range1);

    // Cut the range with the first "Seashell" and copy it to cell B1.
    Microsoft.Office.Tools.Excel.NamedRange namedRange2 =
        this.Controls.AddNamedRange(Range1, "namedRange2");
    namedRange2.Cut(this.Range["B1"]);
}

Private Sub FindValue()
    Me.Range("A1").Value2 = "Barnacle"
    Me.Range("A2").Value2 = "Seashell"
    Me.Range("A3").Value2 = "Star Fish"
    Me.Range("A4").Value2 = "Seashell"
    Me.Range("A5").Value2 = "Clam Shell"

    Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
        = Me.Controls.AddNamedRange(Me.Range("A1", "A5"), _
        "namedRange1")

    ' Find the first occurrence of "Seashell".
    Dim Range1 As Excel.Range = namedRange1.Find("Seashell", , , _
        Excel.XlLookAt.xlWhole, Excel.XlSearchOrder.xlByColumns, _
        Microsoft.Office.Interop.Excel.XlSearchDirection.xlNext, _
        False, False, )

    ' Find the next occurrence of "Seashell".
    Range1 = namedRange1.FindNext(Range1)

    ' Return to the first occurrence of "Seashell".
    Range1 = namedRange1.FindPrevious(Range1)

    ' Cut the range with the first "Seashell" and copy it to cell B1.
    Dim namedRange2 As Microsoft.Office.Tools.Excel.NamedRange _
        = Me.Controls.AddNamedRange(Range1, "namedRange2")
    namedRange2.Cut(Me.Range("B1"))
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 FindNext métodos y FindPrevious para repetir la búsqueda.

Cuando la búsqueda llega al final del intervalo de búsqueda especificado, se ajusta al principio del intervalo. Para detener una búsqueda cuando se produzca este ajuste, guarde la dirección de la primera celda encontrada y, a continuación, pruebe cada dirección de celda encontrada sucesiva en esta dirección guardada.

Parámetros opcionales

Para obtener información sobre los parámetros opcionales, vea Parámetros opcionales en soluciones de Office.

Se aplica a

Compartir a través de