Excel.ValueTypeNotAvailableCellValue interface

Package:
excel

Représente la valeur d’une cellule contenant un type de valeur qui ne peut pas être sérialisé. Par exemple, un #UNKNOWN ! qui représente un type de valeur enrichie inconnu de cette version d’Excel.

Remarques

Jeu d’API : ExcelApi 1.16

Exemples

// 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.");
  }
});

Propriétés

basicType

Représente la valeur qui serait retournée par Range.valueTypes pour une cellule avec cette valeur.
basicValue

Représente la valeur qui serait retournée par Range.values pour une cellule avec cette valeur.
type

Représente le type de cette valeur de cellule.

Détails de la propriété

basicType

Représente la valeur qui serait retournée par Range.valueTypes pour une cellule avec cette valeur.

basicType: RangeValueType | "Boolean" | "Double" | "Error" | "Empty" | "String";

Valeur de propriété

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

Remarques

Jeu d’API : ExcelApi 1.16

basicValue

Représente la valeur qui serait retournée par Range.values pour une cellule avec cette valeur.

basicValue: boolean | number | string;

Valeur de propriété

boolean | number | string

Remarques

Jeu d’API : ExcelApi 1.16

type

Représente le type de cette valeur de cellule.

type: CellValueType.notAvailable | "NotAvailable";

Valeur de propriété

notAvailable | "NotAvailable"

Remarques

Jeu d’API : ExcelApi 1.16