Excel.Interfaces.RangeCollectionLoadOptions interface

Paket:

excel

Hinweise

[ API-Satz: ExcelApi 1.9 ]

Eigenschaften

$all	Wenn Sie für loadOptions angeben$all, werden alle skalaren Eigenschaften (z.Range.address B. ) geladen, aber nicht die Navigationseigenschaften (z. B.: Range.format.fill.color).
address	Für JEDES ELEMENT in der Auflistung: Gibt den Bereichsverweis im A1-Stil an. Der Adresswert enthält den Blattverweis (z. B. "Sheet1! A1:B4").
addressLocal	Für JEDES ELEMENT in der Auflistung: Stellt den Bereichsverweis für den angegebenen Bereich in der Sprache des Benutzers dar.
cellCount	Für JEDES ELEMENT in der Auflistung: Gibt die Anzahl der Zellen im Bereich an. Diese API gibt -1 zurück, wenn die Zellenanzahl 2^31-1 (2.147.483.647) überschreitet.
columnCount	Für JEDES ELEMENT in der Auflistung: Gibt die Gesamtanzahl der Spalten im Bereich an.
columnHidden	Für JEDES ELEMENT in der Auflistung: Stellt dar, ob alle Spalten im aktuellen Bereich ausgeblendet sind. Der Wert ist true , wenn alle Spalten in einem Bereich ausgeblendet sind. Der Wert ist false , wenn keine Spalten im Bereich ausgeblendet werden. Der Wert ist null , wenn einige Spalten in einem Bereich ausgeblendet sind und andere Spalten im gleichen Bereich nicht ausgeblendet werden.
columnIndex	Für JEDES ELEMENT in der Auflistung: Gibt die Spaltennummer der ersten Zelle im Bereich an. Nullindiziert.
dataValidation	Für EACH ITEM in der Auflistung: Gibt ein Datenüberprüfungsobjekt zurück.
format	Für EACH ITEM in der Auflistung: Gibt ein Formatobjekt zurück, das die Schriftart, Füllung, Rahmen, Ausrichtung und andere Eigenschaften des Bereichs kapselt.
formulas	Für JEDES ELEMENT in der Auflistung: Stellt die Formel in der A1-Schreibweise dar. Wenn eine Zelle keine Formel enthält, wird stattdessen ihr Wert zurückgegeben.
formulasLocal	Für JEDES ELEMENT in der Auflistung: Stellt die Formel in der A1-Schreibweise in der Sprache und dem Gebietsschema für die Zahlenformatierung des Benutzers dar. Beispielsweise würde die englische Formel „= SUM(A1, 1.5)“ in Deutsch „= SUMME(A1; 1,5)“ werden. Wenn eine Zelle keine Formel enthält, wird stattdessen ihr Wert zurückgegeben.
formulasR1C1	Für JEDES ELEMENT in der Auflistung: Stellt die Formel im R1C1-Format dar. Wenn eine Zelle keine Formel enthält, wird stattdessen ihr Wert zurückgegeben.
hasSpill	Für JEDES ELEMENT in der Auflistung: Stellt dar, ob alle Zellen über einen Überlaufrahmen verfügen. Gibt zurück true , wenn alle Zellen einen Überlaufrahmen haben oder false wenn alle Zellen keinen Überlaufrahmen haben. Gibt zurück null , wenn sich Zellen mit und ohne Überlaufrahmen innerhalb des Bereichs befinden.
height	Für JEDES ELEMENT in der Auflistung: Gibt den Abstand in Punkt für einen Zoom von 100 % vom oberen Rand des Bereichs bis zum unteren Rand des Bereichs zurück.
hidden	Für JEDES ELEMENT in der Auflistung: Stellt dar, ob alle Zellen im aktuellen Bereich ausgeblendet sind. Der Wert ist true , wenn alle Zellen in einem Bereich ausgeblendet sind. Der Wert ist false , wenn keine Zellen im Bereich ausgeblendet werden. Wert ist null , wenn einige Zellen in einem Bereich ausgeblendet sind und andere Zellen im gleichen Bereich nicht ausgeblendet werden.
hyperlink	Für JEDES ELEMENT in der Auflistung: Stellt den Link für den aktuellen Bereich dar.
isEntireColumn	Für JEDES ELEMENT in der Auflistung: Stellt dar, ob der aktuelle Bereich eine ganze Spalte ist.
isEntireRow	Für JEDES ELEMENT in der Auflistung: Stellt dar, ob der aktuelle Bereich eine ganze Zeile ist.
left	Für JEDES ELEMENT in der Auflistung: Gibt den Abstand in Punkt für einen Zoom von 100 % vom linken Rand des Arbeitsblatts zum linken Rand des Bereichs zurück.
linkedDataTypeState	Für JEDES ELEMENT in der Auflistung: Stellt den Datentypzustand jeder Zelle dar.
numberFormat	Für JEDES ELEMENT in der Auflistung: Stellt den Excel-Zahlenformatcode für den angegebenen Bereich dar. Weitere Informationen zur Excel-Zahlenformatierung finden Sie unter Zahlenformatcodes.
numberFormatCategories	Für JEDES ELEMENT in der Auflistung: Stellt die Kategorie des Zahlenformats jeder Zelle dar.
numberFormatLocal	Für JEDES ELEMENT in der Auflistung: Stellt den Excel-Zahlenformatcode für den angegebenen Bereich basierend auf den Spracheinstellungen des Benutzers dar. Excel führt beim Abrufen oder Festlegen der numberFormatLocal Eigenschaft keine Sprach- oder Formatkoersion aus. Jeder zurückgegebene Text verwendet die lokal formatierten Zeichenfolgen basierend auf der in den Systemeinstellungen angegebenen Sprache.
rowCount	Für EACH ITEM in der Auflistung: Gibt die Gesamtzahl der Zeilen im Bereich zurück.
rowHidden	Für JEDES ELEMENT in der Auflistung: Stellt dar, ob alle Zeilen im aktuellen Bereich ausgeblendet sind. Value ist true , wenn alle Zeilen in einem Bereich ausgeblendet sind. Der Wert ist false , wenn keine Zeilen im Bereich ausgeblendet werden. Der Wert ist null , wenn einige Zeilen in einem Bereich ausgeblendet sind und andere Zeilen im gleichen Bereich nicht ausgeblendet werden.
rowIndex	Für JEDES ELEMENT in der Auflistung: Gibt die Zeilennummer der ersten Zelle im Bereich zurück. Nullindiziert.
savedAsArray	Für JEDES ELEMENT in der Auflistung: Gibt an, ob alle Zellen als Arrayformel gespeichert würden. Gibt zurück true , wenn alle Zellen als Arrayformel gespeichert würden oder false wenn nicht alle Zellen als Arrayformel gespeichert würden. Gibt zurück null , wenn einige Zellen als Arrayformel gespeichert würden und andere nicht.
style	Für JEDES ELEMENT in der Auflistung: Stellt die Formatvorlage des aktuellen Bereichs dar. Wenn die Formatvorlagen der Zellen inkonsistent sind, null wird zurückgegeben. Bei benutzerdefinierten Formatvorlagen wird der Formatvorlagenname zurückgegeben. Bei integrierten Formatvorlagen wird eine Zeichenfolge zurückgegeben, die einen Wert in der BuiltInStyle Enumeration darstellt.
text	Für JEDES ELEMENT in der Auflistung: Textwerte des angegebenen Bereichs. Der Textwert hängt nicht von der Zellenbreite ab. Die Ersetzung des Nummernzeichens (#), die in der Excel-Benutzeroberfläche erfolgt, wirkt sich nicht auf den von der API zurückgegebenen Textwert aus.
top	Für JEDES ELEMENT in der Auflistung: Gibt den Abstand in Punkt für einen Zoom von 100 % vom oberen Rand des Arbeitsblatts bis zum oberen Rand des Bereichs zurück.
values	Für JEDES ELEMENT in der Auflistung: Stellt die Rohwerte des angegebenen Bereichs dar. Bei den zurückgegebenen Daten kann es sich um eine Zeichenfolge, eine Zahl oder einen booleschen Wert handeln. Zellen, die einen Fehler enthalten, geben die Fehlerzeichenfolge zurück. Wenn der zurückgegebene Wert mit einem Pluszeichen ("+"), minus ("-") oder Gleichheitszeichen ("=") beginnt, interpretiert Excel diesen Wert als Formel.
valuesAsJson	Für JEDES ELEMENT in der Auflistung: Eine JSON-Darstellung der Werte in den Zellen in diesem Bereich. Im Gegensatz zu Range.valuesunterstützt Range.valuesAsJson alle Datentypen, die sich in einer Zelle enthalten können. Beispiele hierfür sind formatierte Zahlenwerte und Webbilder sowie boolesche Standard-, Zahlen- und Zeichenfolgenwerte. Von dieser API zurückgegebene Daten entsprechen immer dem Gebietsschema en-US. Verwenden Sie Range.valuesAsJsonLocal, um Daten im Anzeigegebietsschema des Benutzers abzurufen.
valuesAsJsonLocal	Für JEDES ELEMENT in der Auflistung: Eine JSON-Darstellung der Werte in den Zellen in diesem Bereich. Im Gegensatz zu Range.valuesunterstützt Range.valuesAsJsonLocal alle Datentypen, die sich in einer Zelle enthalten können. Beispiele hierfür sind formatierte Zahlenwerte und Webbilder sowie boolesche 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 Range.valuesAsJson.
valueTypes	Für JEDES ELEMENT in der Auflistung: Gibt den Datentyp in jeder Zelle an.
width	Für JEDES ELEMENT in der Auflistung: Gibt den Abstand in Punkt für einen Zoom von 100 % vom linken Rand des Bereichs bis zum rechten Rand des Bereichs zurück.
worksheet	Für JEDES ELEMENT in der Auflistung: Das Arbeitsblatt, das den aktuellen Bereich enthält.

Details zur Eigenschaft

$all

Wenn Sie für loadOptions angeben$all, werden alle skalaren Eigenschaften (z.Range.address B. ) geladen, aber nicht die Navigationseigenschaften (z. B.: Range.format.fill.color).

$all?: boolean;

Eigenschaftswert

boolean

address

Für JEDES ELEMENT in der Auflistung: Gibt den Bereichsverweis im A1-Stil an. Der Adresswert enthält den Blattverweis (z. B. "Sheet1! A1:B4").

address?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.1 ]

addressLocal

Für JEDES ELEMENT in der Auflistung: Stellt den Bereichsverweis für den angegebenen Bereich in der Sprache des Benutzers dar.

addressLocal?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.1 ]

cellCount

Für JEDES ELEMENT in der Auflistung: Gibt die Anzahl der Zellen im Bereich an. Diese API gibt -1 zurück, wenn die Zellenanzahl 2^31-1 (2.147.483.647) überschreitet.

cellCount?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.1 ]

columnCount

Für JEDES ELEMENT in der Auflistung: Gibt die Gesamtanzahl der Spalten im Bereich an.

columnCount?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.1 ]

columnHidden

Für JEDES ELEMENT in der Auflistung: Stellt dar, ob alle Spalten im aktuellen Bereich ausgeblendet sind. Der Wert ist true , wenn alle Spalten in einem Bereich ausgeblendet sind. Der Wert ist false , wenn keine Spalten im Bereich ausgeblendet werden. Der Wert ist null , wenn einige Spalten in einem Bereich ausgeblendet sind und andere Spalten im gleichen Bereich nicht ausgeblendet werden.

columnHidden?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.2 ]

columnIndex

Für JEDES ELEMENT in der Auflistung: Gibt die Spaltennummer der ersten Zelle im Bereich an. Nullindiziert.

columnIndex?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.1 ]

dataValidation

Für EACH ITEM in der Auflistung: Gibt ein Datenüberprüfungsobjekt zurück.

dataValidation?: Excel.Interfaces.DataValidationLoadOptions;

Eigenschaftswert

Excel.Interfaces.DataValidationLoadOptions

Hinweise

[ API-Satz: ExcelApi 1.8 ]

format

Für EACH ITEM in der Auflistung: Gibt ein Formatobjekt zurück, das die Schriftart, Füllung, Rahmen, Ausrichtung und andere Eigenschaften des Bereichs kapselt.

format?: Excel.Interfaces.RangeFormatLoadOptions;

Eigenschaftswert

Excel.Interfaces.RangeFormatLoadOptions

Hinweise

[ API-Satz: ExcelApi 1.1 ]

formulas

Für JEDES ELEMENT in der Auflistung: Stellt die Formel in der A1-Schreibweise dar. Wenn eine Zelle keine Formel enthält, wird stattdessen ihr Wert zurückgegeben.

formulas?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.1 ]

formulasLocal

Für JEDES ELEMENT in der Auflistung: Stellt die Formel in der A1-Schreibweise in der Sprache und dem Gebietsschema für die Zahlenformatierung des Benutzers dar. Beispielsweise würde die englische Formel „= SUM(A1, 1.5)“ in Deutsch „= SUMME(A1; 1,5)“ werden. Wenn eine Zelle keine Formel enthält, wird stattdessen ihr Wert zurückgegeben.

formulasLocal?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.1 ]

formulasR1C1

Für JEDES ELEMENT in der Auflistung: Stellt die Formel im R1C1-Format dar. Wenn eine Zelle keine Formel enthält, wird stattdessen ihr Wert zurückgegeben.

formulasR1C1?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.2 ]

hasSpill

Für JEDES ELEMENT in der Auflistung: Stellt dar, ob alle Zellen über einen Überlaufrahmen verfügen. Gibt zurück true , wenn alle Zellen einen Überlaufrahmen haben oder false wenn alle Zellen keinen Überlaufrahmen haben. Gibt zurück null , wenn sich Zellen mit und ohne Überlaufrahmen innerhalb des Bereichs befinden.

hasSpill?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.12 ]

height

Für JEDES ELEMENT in der Auflistung: Gibt den Abstand in Punkt für einen Zoom von 100 % vom oberen Rand des Bereichs bis zum unteren Rand des Bereichs zurück.

height?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.10 ]

hidden

Für JEDES ELEMENT in der Auflistung: Stellt dar, ob alle Zellen im aktuellen Bereich ausgeblendet sind. Der Wert ist true , wenn alle Zellen in einem Bereich ausgeblendet sind. Der Wert ist false , wenn keine Zellen im Bereich ausgeblendet werden. Wert ist null , wenn einige Zellen in einem Bereich ausgeblendet sind und andere Zellen im gleichen Bereich nicht ausgeblendet werden.

hidden?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.2 ]

hyperlink

Für JEDES ELEMENT in der Auflistung: Stellt den Link für den aktuellen Bereich dar.

hyperlink?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.7 ]

isEntireColumn

Für JEDES ELEMENT in der Auflistung: Stellt dar, ob der aktuelle Bereich eine ganze Spalte ist.

isEntireColumn?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.7 ]

isEntireRow

Für JEDES ELEMENT in der Auflistung: Stellt dar, ob der aktuelle Bereich eine ganze Zeile ist.

isEntireRow?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.7 ]

left

Für JEDES ELEMENT in der Auflistung: Gibt den Abstand in Punkt für einen Zoom von 100 % vom linken Rand des Arbeitsblatts zum linken Rand des Bereichs zurück.

left?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.10 ]

linkedDataTypeState

Für JEDES ELEMENT in der Auflistung: Stellt den Datentypzustand jeder Zelle dar.

linkedDataTypeState?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.9 ]

numberFormat

Für JEDES ELEMENT in der Auflistung: Stellt den Excel-Zahlenformatcode für den angegebenen Bereich dar. Weitere Informationen zur Excel-Zahlenformatierung finden Sie unter Zahlenformatcodes.

numberFormat?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.1 ]

numberFormatCategories

Für JEDES ELEMENT in der Auflistung: Stellt die Kategorie des Zahlenformats jeder Zelle dar.

numberFormatCategories?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.12 ]

numberFormatLocal

Für JEDES ELEMENT in der Auflistung: Stellt den Excel-Zahlenformatcode für den angegebenen Bereich basierend auf den Spracheinstellungen des Benutzers dar. Excel führt beim Abrufen oder Festlegen der numberFormatLocal Eigenschaft keine Sprach- oder Formatkoersion aus. Jeder zurückgegebene Text verwendet die lokal formatierten Zeichenfolgen basierend auf der in den Systemeinstellungen angegebenen Sprache.

numberFormatLocal?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.7 ]

rowCount

Für EACH ITEM in der Auflistung: Gibt die Gesamtzahl der Zeilen im Bereich zurück.

rowCount?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.1 ]

rowHidden

Für JEDES ELEMENT in der Auflistung: Stellt dar, ob alle Zeilen im aktuellen Bereich ausgeblendet sind. Value ist true , wenn alle Zeilen in einem Bereich ausgeblendet sind. Der Wert ist false , wenn keine Zeilen im Bereich ausgeblendet werden. Der Wert ist null , wenn einige Zeilen in einem Bereich ausgeblendet sind und andere Zeilen im gleichen Bereich nicht ausgeblendet werden.

rowHidden?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.2 ]

rowIndex

Für JEDES ELEMENT in der Auflistung: Gibt die Zeilennummer der ersten Zelle im Bereich zurück. Nullindiziert.

rowIndex?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.1 ]

savedAsArray

Für JEDES ELEMENT in der Auflistung: Gibt an, ob alle Zellen als Arrayformel gespeichert würden. Gibt zurück true , wenn alle Zellen als Arrayformel gespeichert würden oder false wenn nicht alle Zellen als Arrayformel gespeichert würden. Gibt zurück null , wenn einige Zellen als Arrayformel gespeichert würden und andere nicht.

savedAsArray?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.12 ]

style

Für JEDES ELEMENT in der Auflistung: Stellt die Formatvorlage des aktuellen Bereichs dar. Wenn die Formatvorlagen der Zellen inkonsistent sind, null wird zurückgegeben. Bei benutzerdefinierten Formatvorlagen wird der Formatvorlagenname zurückgegeben. Bei integrierten Formatvorlagen wird eine Zeichenfolge zurückgegeben, die einen Wert in der BuiltInStyle Enumeration darstellt.

style?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.7 ]

text

Für JEDES ELEMENT in der Auflistung: Textwerte des angegebenen Bereichs. Der Textwert hängt nicht von der Zellenbreite ab. Die Ersetzung des Nummernzeichens (#), die in der Excel-Benutzeroberfläche erfolgt, wirkt sich nicht auf den von der API zurückgegebenen Textwert aus.

text?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.1 ]

top

Für JEDES ELEMENT in der Auflistung: Gibt den Abstand in Punkt für einen Zoom von 100 % vom oberen Rand des Arbeitsblatts bis zum oberen Rand des Bereichs zurück.

top?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.10 ]

values

Für JEDES ELEMENT in der Auflistung: Stellt die Rohwerte des angegebenen Bereichs dar. Bei den zurückgegebenen Daten kann es sich um eine Zeichenfolge, eine Zahl oder einen booleschen Wert handeln. Zellen, die einen Fehler enthalten, geben die Fehlerzeichenfolge zurück. Wenn der zurückgegebene Wert mit einem Pluszeichen ("+"), minus ("-") oder Gleichheitszeichen ("=") beginnt, interpretiert Excel diesen Wert als Formel.

values?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.1 ]

valuesAsJson

Für JEDES ELEMENT in der Auflistung: Eine JSON-Darstellung der Werte in den Zellen in diesem Bereich. Im Gegensatz zu Range.valuesunterstützt Range.valuesAsJson alle Datentypen, die sich in einer Zelle enthalten können. Beispiele hierfür sind formatierte Zahlenwerte und Webbilder sowie boolesche Standard-, Zahlen- und Zeichenfolgenwerte. Von dieser API zurückgegebene Daten entsprechen immer dem Gebietsschema en-US. Verwenden Sie Range.valuesAsJsonLocal, um Daten im Anzeigegebietsschema des Benutzers abzurufen.

valuesAsJson?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.16 ]

valuesAsJsonLocal

Für JEDES ELEMENT in der Auflistung: Eine JSON-Darstellung der Werte in den Zellen in diesem Bereich. Im Gegensatz zu Range.valuesunterstützt Range.valuesAsJsonLocal alle Datentypen, die sich in einer Zelle enthalten können. Beispiele hierfür sind formatierte Zahlenwerte und Webbilder sowie boolesche 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 Range.valuesAsJson.

valuesAsJsonLocal?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.16 ]

valueTypes

Für JEDES ELEMENT in der Auflistung: Gibt den Datentyp in jeder Zelle an.

valueTypes?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.1 ]

width

Für JEDES ELEMENT in der Auflistung: Gibt den Abstand in Punkt für einen Zoom von 100 % vom linken Rand des Bereichs bis zum rechten Rand des Bereichs zurück.

width?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.10 ]

worksheet

Für JEDES ELEMENT in der Auflistung: Das Arbeitsblatt, das den aktuellen Bereich enthält.

worksheet?: Excel.Interfaces.WorksheetLoadOptions;

Eigenschaftswert

Excel.Interfaces.WorksheetLoadOptions

Hinweise

[ API-Satz: ExcelApi 1.1 ]