Excel.ValueTypeNotAvailableCellValue interface

Representa o valor de uma célula que contém um tipo de valor que não pode ser serializado. Por exemplo, um #UNKNOWN! que representa um tipo de valor avançado desconhecido nesta versão do Excel.

Comentários

Conjunto de APIs: ExcelApi 1.16

Exemplos

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

Propriedades

basicType

Representa o valor que seria retornado por Range.valueTypes uma célula com esse valor.

basicValue

Representa o valor que seria retornado por Range.values uma célula com esse valor.

type

Representa o tipo desse valor de célula.

Detalhes da propriedade

basicType

Representa o valor que seria retornado por Range.valueTypes uma célula com esse valor.

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

Valor da propriedade

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

Comentários

Conjunto de APIs: ExcelApi 1.16

basicValue

Representa o valor que seria retornado por Range.values uma célula com esse valor.

basicValue: boolean | number | string;

Valor da propriedade

boolean | number | string

Comentários

Conjunto de APIs: ExcelApi 1.16

type

Representa o tipo desse valor de célula.

type: CellValueType.notAvailable | "NotAvailable";

Valor da propriedade

notAvailable | "NotAvailable"

Comentários

Conjunto de APIs: ExcelApi 1.16