ExcelScript.LinkedWorkbook interface

パッケージ:

ExcelScript

リンクされたブックに関する情報が含まれます。 ブックに別のブック内のデータを指すリンクがある場合、2 番目のブックは最初のブックにリンクされます。 このシナリオでは、2 つ目のブックは "リンクされたブック" と呼ばれます。

メソッド

breakLinks()	リンクされたブックを指すリンクを解除するように要求します。 数式内のリンクは、フェッチされた最新のデータに置き換えられます。 現在の LinkedWorkbook オブジェクトは無効になり、 LinkedWorkbookCollectionから削除されます。
refreshLinks()	リンクされたブックから取得したデータを更新するように要求します。

メソッドの詳細

breakLinks()

リンクされたブックを指すリンクを解除するように要求します。 数式内のリンクは、フェッチされた最新のデータに置き換えられます。 現在の LinkedWorkbook オブジェクトは無効になり、 LinkedWorkbookCollectionから削除されます。

breakLinks(): void;

戻り値

void

例

/**
 * This script removes all links to other workbooks.
 */
function main(workbook: ExcelScript.Workbook) {
    // Get all the linked workbook references.
    const externalWorkbooks: ExcelScript.LinkedWorkbook[] = workbook.getLinkedWorkbooks();
    console.log(`There are ${externalWorkbooks.length} other workbooks linked to from this workbook.`);

    // Remove all the links to those workbooks.
    // This changes the value of cells with workbook links to "#CONNECT!".
    externalWorkbooks.forEach((workbookLink) => {
        workbookLink.breakLinks();
    });
}

refreshLinks()

リンクされたブックから取得したデータを更新するように要求します。

refreshLinks(): void;

戻り値

void