Excel.ValueTypeNotAvailableCellValue interface

Paket:

excel

Stellt den Wert einer Zelle dar, die einen Werttyp enthält, der nicht serialisiert werden kann. Ein #UNKNOWN! Fehler, der einen Rich-Wert darstellt, der in dieser Excel-Version nicht bekannt ist.

Hinweise

API-Satz: ExcelApi 1.16

Beispiele

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

// Read the fallback properties of a value that Excel can't serialize.
await Excel.run(async (context) => {
  const sheet: Excel.Worksheet = context.workbook.worksheets.getItem("Sample");
  const range: Excel.Range = sheet.getRange("B1");
  range.load("valuesAsJson");
  await context.sync();

  const cellValue: Excel.CellValue = range.valuesAsJson[0][0];
  if (cellValue.type === Excel.CellValueType.notAvailable) {
    const unavailableValue: Excel.ValueTypeNotAvailableCellValue = cellValue;
    console.log("B1 value type:", unavailableValue.type);
    console.log("B1 fallback type:", unavailableValue.basicType);
    console.log("B1 fallback value:", unavailableValue.basicValue);
  } else {
    console.log("B1 value type:", cellValue.type);
    console.log("B1's value type is supported. No unavailable-type fallback was returned.");
  }
});

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.
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 | "Boolean" | "Double" | "Error" | "Empty" | "String";

Eigenschaftswert

Excel.RangeValueType | "Boolean" | "Double" | "Error" | "Empty" | "String"

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.

basicValue: boolean | number | string;

Eigenschaftswert

boolean | number | string

Hinweise

API-Satz: ExcelApi 1.16

type

Stellt den Typ dieses Zellwerts dar.

type: CellValueType.notAvailable | "NotAvailable";

Eigenschaftswert

notAvailable | "NotAvailable"

Hinweise

API-Satz: ExcelApi 1.16