Excel.BindingDataChangedEventArgs interface

Fournit des informations sur la liaison qui a déclenché l’événement de modification des données.

Remarques

Jeu d’API : ExcelApi 1.2

Utilisateur

Exemples

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/30-events/data-changed.yaml

async function registerDataChangedHandler() {
    await Excel.run(async (context) => {
        const sheet = context.workbook.worksheets.getItem("Sample");    
        const salesTable = sheet.tables.getItem("SalesTable");
        const salesByQuarterBinding = context.workbook.bindings.add(salesTable.getRange(), "Table", "SalesByQuarter");
        salesByQuarterBinding.onDataChanged.add(onSalesDataChanged);

        console.log("The data changed handler is registered.");

        await context.sync();
    });
}

async function onSalesDataChanged(eventArgs: Excel.BindingDataChangedEventArgs) {
    await Excel.run(async (context) => {
        console.log("Data was changed with binding " + eventArgs.binding.id);
        
        // Get the name of the table that's changed.
        const table: Excel.Table = context.workbook.bindings.getItem(eventArgs.binding.id).getTable();
        table.load("name");

        await context.sync();
        console.log("Name of the changed table: " + table.name);
    });
} 

Propriétés

binding

Obtient un objet temporaire Binding qui contient l’ID de l’objet Binding qui a déclenché l’événement. Utilisez cet ID avec pour BindingCollection.getItem(id) obtenir la liaison.

Détails de la propriété

binding

Obtient un objet temporaire Binding qui contient l’ID de l’objet Binding qui a déclenché l’événement. Utilisez cet ID avec pour BindingCollection.getItem(id) obtenir la liaison.

binding: Excel.Binding;

Valeur de propriété

Remarques

Jeu d’API : ExcelApi 1.2