Suchen einer Zeichenfolge innerhalb eines Bereichs mithilfe der Excel-JavaScript-API

  • Artikel

Dieser Artikel enthält ein Codebeispiel, das mithilfe der Excel-JavaScript-API eine Zeichenfolge innerhalb eines Bereichs findet. Eine vollständige Liste der Eigenschaften und Methoden, die das Range Objekt unterstützt, finden Sie unter Excel.Range-Klasse.

Hinweis

Die Excel-JavaScript-API beinhaltet keine auf „Zellen“ bezogenen Objekte oder Klassen. Stattdessen definiert die Excel-JavaScript-API alle Excel-Zellen als Objekte Range. Eine einzelne Zelle in der Excel-Benutzeroberfläche wird in ein Objekt Range mit einer Zelle der Excel-JavaScript-API übersetzt. Ein einzelnes Objekt Range kann auch mehrere zusammenhängende Zellen beinhalten. Weitere Informationen finden Sie unter Arbeiten mit Zellen mithilfe der Excel-JavaScript-API.

Abgleichen einer Zeichenfolge innerhalb eines Bereichs

Das Range-Objekt verfügt über eine find-Methode für die Suche nach einer angegebenen Zeichenfolge innerhalb des Bereichs. Es gibt den Bereich der ersten Zelle mit dem übereinstimmenden Text zurück.

Das folgende Codebeispiel findet die erste Zelle mit einem Wert, der der Zeichenfolge Essen entspricht, und meldet die Adresse bei der Konsole an. Beachten Sie, dass find einen ItemNotFound-Fehler ausgibt, wenn die angegebene Zeichenfolge nicht im Bereich vorhanden ist. Wenn Sie vermuten, dass die angegebene Zeichenfolge möglicherweise nicht im Bereich vorhanden ist, verwenden Sie stattdessen die Methode findOrNullObject, damit Ihr Code das Szenario ordnungsgemäß abwickelt.

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

Wenn die find-Methode für einen Bereich mit einer einzelnen Zelle aufgerufen wird, wird das gesamte Arbeitsblatt durchsucht. Die Suche beginnt bei dieser Zelle und wird in der durch SearchCriteria.searchDirection festgelegten Richtung fortgesetzt, wobei bei Bedarf an den Enden des Arbeitsblatts ein Umbruch erfolgt.

Siehe auch