Excel.EntityCellValue interface

Пакет:

excel

Представляет набор свойств без схемы или определенной структуры.

Комментарии

Набор API: ExcelApi 1.16

Примеры

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/20-data-types/data-types-function-references.yaml

// Attach a reference to a JavaScript custom function as a method on a math entity.
await Excel.run(async (context) => {
    const sheet: Excel.Worksheet = context.workbook.worksheets.getItem("Sample");
    const entityRange: Excel.Range = sheet.getRange("A2");
    const referenceType: Excel.FunctionCellValueType = Excel.FunctionCellValueType.javaScriptReference;
    const customFunctionReference: Excel.JavaScriptCustomFunctionReferenceCellValue = {
        type: Excel.CellValueType.function,
        functionType: referenceType,
        namespace: "CONTOSO",
        id: "GET27"
    };

    // The namespace and ID identify a function; this value doesn't register its implementation.
    const mathEntity: Excel.EntityCellValue = {
        type: Excel.CellValueType.entity,
        text: "Math value",
        properties: {
            Value: {
                type: Excel.CellValueType.double,
                basicValue: 10
            },
            Get27: customFunctionReference
        }
    };
    entityRange.valuesAsJson = [[mathEntity]];
    entityRange.format.autofitColumns();
    await context.sync();
    console.log("Created the Math value entity in Sample!A2. Read the reference to inspect its metadata.");
});

Свойства

basicType	Представляет значение, которое будет возвращено для ячейки Range.valueTypes с этим значением.
basicValue	Представляет значение, которое будет возвращено для ячейки Range.values с этим значением. При доступе через свойство valuesAsJson это строковое значение соответствует языковому стандарту en-US. При доступе через valuesAsJsonLocal свойство это строковое значение соответствует языковому стандарту отображения, выбранному пользователем.
layouts	Представляет информацию о структуре для представлений этого объекта.
properties	Представляет свойства этой сущности и ее метаданные.
provider	Представляет сведения, описывающие службу, предоставившую данные в этом EntityCellValueфайле. Эти сведения можно использовать для фирменной символики в карточках организаций.
referencedValues	Представляет значения ячеек, на которые ссылается .EntityCellValue.properties
text	Представляет текст, отображаемый при отображении ячейки с этим значением.
type	Представляет тип значения ячейки.

Сведения о свойстве

basicType

Представляет значение, которое будет возвращено для ячейки Range.valueTypes с этим значением.

basicType?: RangeValueType.error | "Error";

Значение свойства

error | "Error"

Комментарии

Набор API: ExcelApi 1.16

basicValue

Представляет значение, которое будет возвращено для ячейки Range.values с этим значением. При доступе через свойство valuesAsJson это строковое значение соответствует языковому стандарту en-US. При доступе через valuesAsJsonLocal свойство это строковое значение соответствует языковому стандарту отображения, выбранному пользователем.

basicValue?: "#VALUE!" | string;

Значение свойства

"#VALUE!" | string

Комментарии

Набор API: ExcelApi 1.16

layouts

Представляет информацию о структуре для представлений этого объекта.

layouts?: EntityViewLayouts;

Значение свойства

Excel.EntityViewLayouts

Комментарии

Набор API: ExcelApi 1.16

properties

Представляет свойства этой сущности и ее метаданные.

properties?: {
            [key: string]: EntityPropertyType;
        };

Значение свойства

{ [key: string]: Excel.EntityPropertyType; }

Комментарии

Набор API: ExcelApi 1.16

provider

Представляет сведения, описывающие службу, предоставившую данные в этом EntityCellValueфайле. Эти сведения можно использовать для фирменной символики в карточках организаций.

provider?: CellValueProviderAttributes;

Значение свойства

Excel.CellValueProviderAttributes

Комментарии

Набор API: ExcelApi 1.16

referencedValues

Представляет значения ячеек, на которые ссылается .EntityCellValue.properties

referencedValues?: ReferencedValue[];

Значение свойства

Excel.ReferencedValue[]

Комментарии

Набор API: ExcelApi 1.16

text

Представляет текст, отображаемый при отображении ячейки с этим значением.

text?: string;

Значение свойства

string

Комментарии

Набор API: ExcelApi 1.16

type

Представляет тип значения ячейки.

type: CellValueType.entity | ReferenceValueType.entity | "Entity";

Значение свойства

entity | entity | "Entity"

Комментарии

Набор API: ExcelApi 1.16