Excel.SearchCriteria interface

Paquet:
excel

Représente les critères de recherche à utiliser.

Remarques

Ensemble d’API : ExcelApi 1.9

Utilisateur

Exemples

await Excel.run(async (context) => {
    const sheet = context.workbook.worksheets.getItem("Sample");
    const table = sheet.tables.getItem("ExpensesTable");
    const searchRange = table.getRange();
    
    // Search for cells that exactly match "TODO", ignoring case, and starting from the top-left of the range and going forward.
    const searchCriteria: Excel.SearchCriteria = {
        completeMatch: true,
        matchCase: false,
        searchDirection: Excel.SearchDirection.forward
    };
    const foundRange = searchRange.findOrNullObject("TODO", searchCriteria);
    foundRange.load("address");
    await context.sync();

    if (foundRange.isNullObject) {
        console.log("Text not found");
    } else {
        console.log(foundRange.address);
    }
});

Propriétés

completeMatch

Spécifie si la correspondance doit être complète ou partielle. Une correspondance complète correspond à l’intégralité du contenu de la cellule. Une correspondance partielle correspond à une sous-chaîne dans le contenu de la cellule (par exemple, cat correspond partiellement à et scattercaterpillar ). La valeur par défaut est false (partielle).
matchCase

Spécifie si la correspondance respecte la casse. La valeur par défaut est false (ne respectant pas la casse).
searchDirection

Détermine le sens de la recherche. Par défaut est transférer. Voir Excel.SearchDirection (en anglais).

Détails de la propriété

completeMatch

Spécifie si la correspondance doit être complète ou partielle. Une correspondance complète correspond à l’intégralité du contenu de la cellule. Une correspondance partielle correspond à une sous-chaîne dans le contenu de la cellule (par exemple, cat correspond partiellement à et scattercaterpillar ). La valeur par défaut est false (partielle).

completeMatch?: boolean;

Valeur de propriété

boolean

Remarques

Ensemble d’API : ExcelApi 1.9

matchCase

Spécifie si la correspondance respecte la casse. La valeur par défaut est false (ne respectant pas la casse).

matchCase?: boolean;

Valeur de propriété

boolean

Remarques

Ensemble d’API : ExcelApi 1.9

searchDirection

Détermine le sens de la recherche. Par défaut est transférer. Voir Excel.SearchDirection (en anglais).

searchDirection?: Excel.SearchDirection | "Forward" | "Backwards";

Valeur de propriété

Excel.SearchDirection | "Forward" | "Backwards"

Remarques

Ensemble d’API : ExcelApi 1.9