Excel.ArrayCellValue interface

Paket:
excel

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 für eine Zelle mit diesem Wert zurückgegeben Range.valueTypes würde.
basicValue

Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.values würde. Wenn über eine valuesAsJson Eigenschaft auf diesen Zeichenfolgenwert zugegriffen wird, entspricht er dem Gebietsschema en-US. Wenn über eine valuesAsJsonLocal Eigenschaft auf diesen Zeichenfolgenwert zugegriffen wird, richtet er sich nach dem Anzeigegebietsschema des Benutzers.
elements

Stellt die Elemente des Arrays dar. Darf eine ArrayCellValue.
referencedValues

Stellt die Zellwerte dar, auf die innerhalb ArrayCellValue.elementsverwiesen wird.
type

Stellt den Typ dieses Zellwerts dar.

Details zur Eigenschaft

basicType

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

basicType?: RangeValueType.error | "Error";

Eigenschaftswert

error | "Error"

Hinweise

API-Satz: ExcelApi 1.16

basicValue

Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.values würde. Wenn über eine valuesAsJson Eigenschaft auf diesen Zeichenfolgenwert zugegriffen wird, entspricht er dem Gebietsschema en-US. Wenn über eine valuesAsJsonLocal Eigenschaft auf diesen Zeichenfolgenwert zugegriffen wird, richtet er sich nach dem Anzeigegebietsschema des Benutzers.

basicValue?: "#VALUE!" | string;

Eigenschaftswert

"#VALUE!" | string

Hinweise

API-Satz: ExcelApi 1.16

elements

Stellt die Elemente des Arrays dar. Darf eine ArrayCellValue.

elements: CellValue[][];

Eigenschaftswert

Excel.CellValue[][]

Hinweise

API-Satz: ExcelApi 1.16

referencedValues

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

referencedValues?: ReferencedValue[];

Eigenschaftswert

Excel.ReferencedValue[]

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