Excel.Interfaces.NamedItemLoadOptions interface
Stellt einen definierten Namen für einen Zellbereich oder einen Wert dar. Namen können primitive benannte Objekte (wie im folgenden Typ zu sehen), Bereichsobjekte oder ein Verweis auf einen Bereich sein. Dieses Objekt kann zum Abrufen des mit Namen verknüpften Bereichsobjekts verwendet werden.
Hinweise
Eigenschaften
$all | Wenn Sie |
array |
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 |
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 |
Eine JSON-Darstellung der Werte in diesem benannten Element. Im Gegensatz zu |
value |
Eine JSON-Darstellung der Werte in diesem benannten Element. Im Gegensatz zu |
visible | Gibt an, ob das Objekt sichtbar ist. |
worksheet | Gibt das Arbeitsblatt zurück, auf dessen Bereich das benannte Element beschränkt ist. Löst einen Fehler aus, wenn das Element stattdessen auf die Arbeitsmappe ausgerichtet ist. |
worksheet |
Gibt das Arbeitsblatt zurück, für das das benannte Element gültig ist. Wenn das Element stattdessen auf die Arbeitsmappe ausgerichtet ist, gibt diese Methode ein Objekt zurück, dessen |
Details zur Eigenschaft
$all
Wenn Sie $all
für die Ladeoptionen angeben, werden alle skalaren Eigenschaften (zRange.address
. B. ) geladen, aber nicht die Navigationseigenschaften (zRange.format.fill.color
. B. ).
$all?: boolean;
Eigenschaftswert
boolean
arrayValues
Gibt ein Objekt mit Werten und Typen des benannten Elements zurück.
arrayValues?: Excel.Interfaces.NamedItemArrayValuesLoadOptions;
Eigenschaftswert
Hinweise
comment
Gibt den Kommentar an, der diesem Namen zugeordnet ist.
comment?: boolean;
Eigenschaftswert
boolean
Hinweise
formula
Die Formel des benannten Elements. Formeln beginnen immer mit einem Gleichheitszeichen ("=").
formula?: boolean;
Eigenschaftswert
boolean
Hinweise
name
scope
Gibt an, ob der Name auf die Arbeitsmappe oder ein bestimmtes Arbeitsblatt festgelegt ist. Mögliche Werte sind: Worksheet, Workbook.
scope?: boolean;
Eigenschaftswert
boolean
Hinweise
type
Gibt den Typ des Werts an, der von der Formel des Namens zurückgegeben wird. Weitere Informationen finden Sie unter Excel.NamedItemType
.
type?: boolean;
Eigenschaftswert
boolean
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?: boolean;
Eigenschaftswert
boolean
Hinweise
valueAsJson
Eine JSON-Darstellung der Werte in diesem benannten Element. Im Gegensatz zu NamedItem.value
unterstü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?: boolean;
Eigenschaftswert
boolean
Hinweise
valueAsJsonLocal
Eine JSON-Darstellung der Werte in diesem benannten Element. Im Gegensatz zu NamedItem.value
unterstü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?: boolean;
Eigenschaftswert
boolean
Hinweise
visible
Gibt an, ob das Objekt sichtbar ist.
visible?: boolean;
Eigenschaftswert
boolean
Hinweise
worksheet
Gibt das Arbeitsblatt zurück, auf dessen Bereich das benannte Element beschränkt ist. Löst einen Fehler aus, wenn das Element stattdessen auf die Arbeitsmappe ausgerichtet ist.
worksheet?: Excel.Interfaces.WorksheetLoadOptions;
Eigenschaftswert
Hinweise
worksheetOrNullObject
Gibt das Arbeitsblatt zurück, für das das benannte Element gültig ist. Wenn das Element stattdessen auf die Arbeitsmappe ausgerichtet ist, gibt diese Methode ein Objekt zurück, dessen isNullObject
-Eigenschaft auf true
festgelegt ist. Weitere Informationen finden Sie unter *OrNullObject-Methoden und -Eigenschaften.
worksheetOrNullObject?: Excel.Interfaces.WorksheetLoadOptions;
Eigenschaftswert
Hinweise
Office Add-ins