Freigeben über


Excel.Interfaces.NamedItemData interface

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

Eigenschaften

arrayValues

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

comment

Gibt den Kommentar an, der diesem Namen zugeordnet ist.

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 festgelegt ist. Mögliche Werte sind: Worksheet, Workbook.

type

Gibt den Typ des Werts an, der von der Formel des Namens zurückgegeben wird. Weitere Informationen finden Sie unter 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! 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 zu NamedItem.valueunterstützt NamedItem.valueAsJson alle Datentypen, die sich in einer Zelle enthalten können. Beispiele hierfür sind formatierte Zahlenwerte und Webbilder sowie die booleschen Standard-, Zahlen- und Zeichenfolgenwerte. Von dieser API zurückgegebene Daten entsprechen immer dem Gebietsschema en-US. Verwenden Sie NamedItem.valueAsJsonLocal, um Daten im Anzeigegebietsschema des Benutzers abzurufen.

valueAsJsonLocal

Eine JSON-Darstellung der Werte in diesem benannten Element. Im Gegensatz zu NamedItem.valueunterstützt NamedItem.valueAsJsonLocal alle Datentypen, die sich in einer Zelle enthalten können. Beispiele hierfür sind formatierte Zahlenwerte und Webbilder sowie die booleschen Standard-, Zahlen- und Zeichenfolgenwerte. Von dieser API zurückgegebene Daten sind immer am Anzeigegebietsschema des Benutzers ausgerichtet. 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 Kommentar an, der diesem Namen zugeordnet ist.

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 festgelegt ist. Mögliche Werte sind: Worksheet, Workbook.

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 finden Sie unter 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 String,Integer,Double,Boolean,Range,Error; 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! 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 zu NamedItem.valueunterstützt NamedItem.valueAsJson alle Datentypen, die sich in einer Zelle enthalten können. Beispiele hierfür sind formatierte Zahlenwerte und Webbilder sowie die booleschen Standard-, Zahlen- und Zeichenfolgenwerte. Von dieser API zurückgegebene Daten entsprechen immer dem Gebietsschema en-US. Verwenden Sie NamedItem.valueAsJsonLocal, um Daten im Anzeigegebietsschema des Benutzers abzurufen.

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 zu NamedItem.valueunterstützt NamedItem.valueAsJsonLocal alle Datentypen, die sich in einer Zelle enthalten können. Beispiele hierfür sind formatierte Zahlenwerte und Webbilder sowie die booleschen Standard-, Zahlen- und Zeichenfolgenwerte. Von dieser API zurückgegebene Daten sind immer am Anzeigegebietsschema des Benutzers ausgerichtet. 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 ]