Excel.ArrayCellValue interface

Stellt ein 2D-Array von Zellwerten dar.

Hinweise

API-Satz: ExcelApi 1.16

Beispiele

const sheet = context.workbook.worksheets.getActiveWorksheet();

// This `EntityCellValue` contains an `ArrayCellValue` with two products and their prices.
const myEntity: Excel.EntityCellValue = {
    type: Excel.CellValueType.entity,
    text: "Product Catalog",
    properties: {
        items: {
            type: Excel.CellValueType.array, /* ArrayCellValue */
            elements: [[
                {
                    type: Excel.CellValueType.string,
                    basicValue: "Bicycle"
                },
                {
                    type: Excel.CellValueType.double,
                    basicValue: 300,
                    numberFormat: "$* #,##0.00",
                }
            ],
            [
                {
                    type: Excel.CellValueType.string,
                    basicValue: "Helmet"
                },
                {
                    type: Excel.CellValueType.double,
                    basicValue: 25,
                    numberFormat: "$* #,##0.00",
                }           
            ]],
            basicType: Excel.RangeValueType.error,
            basicValue: "#VALUE!"
        }
    },
    basicType: Excel.RangeValueType.error, // A read-only property. Used as a fallback in incompatible scenarios.
    basicValue: "#VALUE!" // A read-only property. Used as a fallback in incompatible scenarios.
};

sheet.getCell(0,0).valuesAsJson = [[myEntity]];

Eigenschaften

basicType

Stellt den Wert dar, der von Range.valueTypes für eine Zelle mit diesem Wert zurückgegeben wird.

basicValue

Stellt den Wert dar, der von Range.values für eine Zelle mit diesem Wert zurückgegeben wird. Beim Zugriff über eine valuesAsJson Eigenschaft wird dieser Zeichenfolgenwert am Gebietsschema en-US ausgerichtet. Beim Zugriff über eine valuesAsJsonLocal Eigenschaft wird dieser Zeichenfolgenwert am Anzeigegebietsschema des Benutzers ausgerichtet.

elements

Stellt die Elemente des Arrays dar. Darf nicht direkt eine ArrayCellValueenthalten.

referencedValues

Stellt die Zellwerte dar, auf die in ArrayCellValue.elementsverwiesen wird.

type

Stellt den Typ dieses Zellwerts dar.

Details zur Eigenschaft

basicType

Stellt den Wert dar, der von Range.valueTypes für eine Zelle mit diesem Wert zurückgegeben wird.

basicType?: RangeValueType.error | "Error";

Eigenschaftswert

error | "Error"

Hinweise

API-Satz: ExcelApi 1.16

basicValue

Stellt den Wert dar, der von Range.values für eine Zelle mit diesem Wert zurückgegeben wird. Beim Zugriff über eine valuesAsJson Eigenschaft wird dieser Zeichenfolgenwert am Gebietsschema en-US ausgerichtet. Beim Zugriff über eine valuesAsJsonLocal Eigenschaft wird dieser Zeichenfolgenwert am Anzeigegebietsschema des Benutzers ausgerichtet.

basicValue?: "#VALUE!" | string;

Eigenschaftswert

"#VALUE!" | string

Hinweise

API-Satz: ExcelApi 1.16

elements

Stellt die Elemente des Arrays dar. Darf nicht direkt eine ArrayCellValueenthalten.

elements: CellValue[][];

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.16

referencedValues

Stellt die Zellwerte dar, auf die in ArrayCellValue.elementsverwiesen wird.

referencedValues?: ReferencedValue[];

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.16

type

Stellt den Typ dieses Zellwerts dar.

type: CellValueType.array | ReferenceValueType.array | "Array";

Eigenschaftswert

array | array | "Array"

Hinweise

API-Satz: ExcelApi 1.16