Abrufen eines Bereichs mithilfe der Excel-JavaScript-API

  • Artikel

Dieser Artikel enthält Beispiele, die verschiedene Möglichkeiten zum Abrufen eines Bereichs innerhalb eines Arbeitsblatts mithilfe der Excel-JavaScript-API zeigen. 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.

Abrufen eines Bereichs mithilfe der Adresse

Im folgenden Codebeispiel wird der Bereich mit der Adresse B2:C5 aus dem Arbeitsblatt Sample abgerufen, dessen address Eigenschaft geladen und eine Nachricht in die Konsole geschrieben.

await Excel.run(async (context) => {
    let sheet = context.workbook.worksheets.getItem("Sample");
    
    let range = sheet.getRange("B2:C5");
    range.load("address");
    await context.sync();
    
    console.log(`The address of the range B2:C5 is "${range.address}"`);
});

Abrufen eines Bereichs mithilfe des Namens

Im folgenden Codebeispiel wird der Bereich namens MyRangeSample aus dem Arbeitsblatt abgerufen, dessen address Eigenschaft geladen und eine Nachricht in die Konsole geschrieben.

await Excel.run(async (context) => {
    let sheet = context.workbook.worksheets.getItem("Sample");

    let range = sheet.getRange("MyRange");
    range.load("address");
    await context.sync();

    console.log(`The address of the range "MyRange" is "${range.address}"`);
});

Abrufen des verwendeten Bereichs

Im folgenden Codebeispiel wird der verwendete Bereich aus dem Arbeitsblatt Sample abgerufen, dessen address Eigenschaft geladen und eine Nachricht in die Konsole geschrieben. Der verwendete Bereich ist der kleinste Bereich, der mindestens eine der Zellen des Arbeitsblattes umfasst, die einen Wert enthalten oder denen eine Formatierung zugewiesen wurde. Wenn das gesamte Arbeitsblatt leer ist, gibt die getUsedRange() Methode einen Bereich zurück, der nur aus der oberen linken Zelle besteht.

await Excel.run(async (context) => {
    let sheet = context.workbook.worksheets.getItem("Sample");

    let range = sheet.getUsedRange();
    range.load("address");
    await context.sync();
    
    console.log(`The address of the used range in the worksheet is "${range.address}"`);
});

Abrufen des gesamten Bereichs

Im folgenden Codebeispiel wird der gesamte Arbeitsblattbereich aus dem Arbeitsblatt Sample abgerufen, dessen address Eigenschaft geladen und eine Nachricht in die Konsole geschrieben.

await Excel.run(async (context) => {
    let sheet = context.workbook.worksheets.getItem("Sample");

    let range = sheet.getRange();
    range.load("address");
    await context.sync();
    
    console.log(`The address of the entire worksheet range is "${range.address}"`);
});

Siehe auch