Excel.Interfaces.NamedItemData interface

Eine Schnittstelle, die die durch Aufrufen namedItem.toJSON()zurückgegebenen Daten beschreibt.

Hinweise

Verwendet von

Eigenschaften

arrayValues

Gibt ein Objekt mit Werten und Typen des benannten Elements zurück.

comment

Gibt den mit diesem Namen verbundenen Kommentar an.

formula

Die Formel des benannten Elements. Formeln beginnen immer mit einem Gleichheitszeichen ("=").

name

Der Name des Objekts.

scope

Gibt an, ob der Name auf die Arbeitsmappe oder ein bestimmtes Arbeitsblatt beschränkt ist. Mögliche Werte sind: Arbeitsblatt, Arbeitsmappe.

type

Gibt den Typ des Werts an, der von der Formel des Namens zurückgegeben wird. Weitere Informationen findest du hier Excel.NamedItemType .

value

Stellt den Wert dar, der von der Formel des Namens berechnet wurde. Für einen benannten Bereich wird die Bereichsadresse zurückgegeben. Diese API gibt die #VALUE zurück! Fehler in der Excel-Benutzeroberfläche, wenn er auf eine benutzerdefinierte Funktion verweist.

valueAsJson

Eine JSON-Darstellung der Werte in diesem benannten Element. Im Gegensatz NamedItem.valuezu unterstützt unterstützt dies alle Datentypen, NamedItem.valueAsJson die sich in einer Zelle befinden können. Beispiele sind neben den standardmäßigen booleschen, numerischen und Zeichenfolgenwerten auch formatierte Zahlenwerte und Webbilder. Von dieser API zurückgegebene Daten stimmen immer mit dem Gebietsschema en-US überein. Um Daten im Anzeigegebietsschema des Benutzers abzurufen, verwenden Sie NamedItem.valueAsJsonLocal.

valueAsJsonLocal

Eine JSON-Darstellung der Werte in diesem benannten Element. Im Gegensatz NamedItem.valuezu unterstützt unterstützt dies alle Datentypen, NamedItem.valueAsJsonLocal die sich in einer Zelle befinden können. Beispiele sind neben den standardmäßigen booleschen, numerischen und Zeichenfolgenwerten auch formatierte Zahlenwerte und Webbilder. Die von dieser API zurückgegebenen Daten entsprechen immer dem Anzeigegebietsschema des Benutzers. Um Daten unabhängig vom Gebietsschema abzurufen, verwenden Sie NamedItem.valueAsJson.

visible

Gibt an, ob das Objekt sichtbar ist.

Details zur Eigenschaft

arrayValues

Gibt ein Objekt mit Werten und Typen des benannten Elements zurück.

arrayValues?: Excel.Interfaces.NamedItemArrayValuesData;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.7

comment

Gibt den mit diesem Namen verbundenen Kommentar an.

comment?: string;

Eigenschaftswert

string

Hinweise

API-Satz: ExcelApi 1.4

formula

Die Formel des benannten Elements. Formeln beginnen immer mit einem Gleichheitszeichen ("=").

formula?: any;

Eigenschaftswert

any

Hinweise

API-Satz: ExcelApi 1.7

name

Der Name des Objekts.

name?: string;

Eigenschaftswert

string

Hinweise

API-Satz: ExcelApi 1.1

scope

Gibt an, ob der Name auf die Arbeitsmappe oder ein bestimmtes Arbeitsblatt beschränkt ist. Mögliche Werte sind: Arbeitsblatt, Arbeitsmappe.

scope?: Excel.NamedItemScope | "Worksheet" | "Workbook";

Eigenschaftswert

Excel.NamedItemScope | "Worksheet" | "Workbook"

Hinweise

API-Satz: ExcelApi 1.4

type

Gibt den Typ des Werts an, der von der Formel des Namens zurückgegeben wird. Weitere Informationen findest du hier Excel.NamedItemType .

type?: Excel.NamedItemType | "String" | "Integer" | "Double" | "Boolean" | "Range" | "Error" | "Array";

Eigenschaftswert

Excel.NamedItemType | "String" | "Integer" | "Double" | "Boolean" | "Range" | "Error" | "Array"

Hinweise

API-Satz: ExcelApi 1.1 für Zeichenfolge,Ganzzahl,Double,Boolescher,Bereich,Fehler; 1.7 für Array

value

Stellt den Wert dar, der von der Formel des Namens berechnet wurde. Für einen benannten Bereich wird die Bereichsadresse zurückgegeben. Diese API gibt die #VALUE zurück! Fehler in der Excel-Benutzeroberfläche, wenn er auf eine benutzerdefinierte Funktion verweist.

value?: any;

Eigenschaftswert

any

Hinweise

API-Satz: ExcelApi 1.1

valueAsJson

Eine JSON-Darstellung der Werte in diesem benannten Element. Im Gegensatz NamedItem.valuezu unterstützt unterstützt dies alle Datentypen, NamedItem.valueAsJson die sich in einer Zelle befinden können. Beispiele sind neben den standardmäßigen booleschen, numerischen und Zeichenfolgenwerten auch formatierte Zahlenwerte und Webbilder. Von dieser API zurückgegebene Daten stimmen immer mit dem Gebietsschema en-US überein. Um Daten im Anzeigegebietsschema des Benutzers abzurufen, verwenden Sie NamedItem.valueAsJsonLocal.

valueAsJson?: CellValue | string;

Eigenschaftswert

Excel.CellValue | string

Hinweise

API-Satz: ExcelApi 1.16

valueAsJsonLocal

Eine JSON-Darstellung der Werte in diesem benannten Element. Im Gegensatz NamedItem.valuezu unterstützt unterstützt dies alle Datentypen, NamedItem.valueAsJsonLocal die sich in einer Zelle befinden können. Beispiele sind neben den standardmäßigen booleschen, numerischen und Zeichenfolgenwerten auch formatierte Zahlenwerte und Webbilder. Die von dieser API zurückgegebenen Daten entsprechen immer dem Anzeigegebietsschema des Benutzers. Um Daten unabhängig vom Gebietsschema abzurufen, verwenden Sie NamedItem.valueAsJson.

valueAsJsonLocal?: CellValue | string;

Eigenschaftswert

Excel.CellValue | string

Hinweise

API-Satz: ExcelApi 1.16

visible

Gibt an, ob das Objekt sichtbar ist.

visible?: boolean;

Eigenschaftswert

boolean

Hinweise

API-Satz: ExcelApi 1.1