Excel.SearchCriteria interface

Stellt die zu verwendenden Suchkriterien dar.

Hinweise

API-Satz: ExcelApi 1.9

Verwendet von

Beispiele

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);
    }
});

Eigenschaften

completeMatch

Gibt an, ob die Übereinstimmung vollständig oder teilweise sein muss. Eine vollständige Übereinstimmung entspricht dem gesamten Inhalt der Zelle. Eine partielle Übereinstimmung entspricht einer Teilzeichenfolge innerhalb des Inhalts der Zelle (z. B. partielle Übereinstimmungen catcaterpillar und scatter). Der Standardwert ist false (teilweise).

matchCase

Gibt an, ob bei der Übereinstimmung die Groß-/Kleinschreibung beachtet wird. Der Standardwert ist false (Groß-/Kleinschreibung wird nicht beachtet).

searchDirection

Gibt die Suchrichtung an. Der Standardwert ist vorwärts. Weitere Informationen finden Sie unter Excel.SearchDirection.

Details zur Eigenschaft

completeMatch

Gibt an, ob die Übereinstimmung vollständig oder teilweise sein muss. Eine vollständige Übereinstimmung entspricht dem gesamten Inhalt der Zelle. Eine partielle Übereinstimmung entspricht einer Teilzeichenfolge innerhalb des Inhalts der Zelle (z. B. partielle Übereinstimmungen catcaterpillar und scatter). Der Standardwert ist false (teilweise).

completeMatch?: boolean;

Eigenschaftswert

boolean

Hinweise

API-Satz: ExcelApi 1.9

matchCase

Gibt an, ob bei der Übereinstimmung die Groß-/Kleinschreibung beachtet wird. Der Standardwert ist false (Groß-/Kleinschreibung wird nicht beachtet).

matchCase?: boolean;

Eigenschaftswert

boolean

Hinweise

API-Satz: ExcelApi 1.9

searchDirection

Gibt die Suchrichtung an. Der Standardwert ist vorwärts. Weitere Informationen finden Sie unter Excel.SearchDirection.

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

Eigenschaftswert

Excel.SearchDirection | "Forward" | "Backwards"

Hinweise

API-Satz: ExcelApi 1.9