Búsqueda de una cadena dentro de un intervalo mediante la API de JavaScript de Excel

  • Artículo

En este artículo se proporciona un ejemplo de código que busca una cadena dentro de un intervalo mediante la API de JavaScript de Excel. Para obtener la lista completa de propiedades y métodos que admite el Range objeto, vea Clase Excel.Range.

Nota:

La API de JavaScript para Excel no tiene un objeto o clase de "Celda". En su lugar, se definen todas las celdas de Excel como objetos Range. Una celda individual en la interfaz de usuario de Excel se traduce en un objeto Range con una celda en la API de JavaScript para Excel. Un solo objeto Range también puede contener varias celdas contiguas. Consulte Trabajar con celdas mediante la API de JavaScript para Excel para obtener más información.

Coincidencia de una cadena dentro de un intervalo

El objeto Range tiene un método find para buscar una cadena especificada en el rango. Devuelve el rango de la primera celda con texto coincidente.

En el ejemplo siguiente se encuentra la primera celda con un valor igual a la cadena Comida y registra su dirección en la consola. Tenga en cuenta que find producirá un error ItemNotFound si no existe la cadena especificada en el rango. Si espera que la cadena especificada no exista en el rango, use el método findAllOrNullObject para que el código controle correctamente ese escenario.

await Excel.run(async (context) => {
    let sheet = context.workbook.worksheets.getItem("Sample");
    let table = sheet.tables.getItem("ExpensesTable");
    let searchRange = table.getRange();
    let foundRange = searchRange.find("Food", {
        completeMatch: true, // Match the whole cell value.
        matchCase: false, // Don't match case.
        searchDirection: Excel.SearchDirection.forward // Start search at the beginning of the range.
    });

    foundRange.load("address");
    await context.sync();

    console.log(foundRange.address);
});

Cuando se llama al método find en un rango que representa una única celda, se busca toda la hoja de cálculo. La búsqueda comienza en esa celda y pasa a la dirección especificada por SearchCriteria.searchDirection, envolviendo los extremos de la hoja de cálculo si es necesario.

Vea también