Excel.SearchCriteria interface

Paket:
excel

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 Zellinhalts (z. cat B. teilweise übereinstimmungen caterpillar und scatter). Der Standardwert ist false (partielle).
matchCase

Gibt an, ob bei der Übereinstimmung die Groß-/Kleinschreibung beachtet wird. Der Standardwert ist false (ohne Berücksichtigung der Groß-/Kleinschreibung).
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 Zellinhalts (z. cat B. teilweise übereinstimmungen caterpillar und scatter). Der Standardwert ist false (partielle).

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 (ohne Berücksichtigung der Groß-/Kleinschreibung).

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