Share via

Excel.Interfaces.RangeData interface

  • Referenz
Paket:
excel

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

Eigenschaften

address

Gibt den Bereichsverweis im A1-Stil an. Der Adresswert enthält den Blattverweis (z. B. "Sheet1! A1:B4").
addressLocal

Stellt den Bereichsverweis für den angegebenen Bereich in der Sprache des Benutzers dar.
cellCount

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

Gibt die Gesamtanzahl der Spalten im Bereich an.
columnIndex

Gibt die Spaltennummer der ersten Zelle im Bereich an. Nullindiziert.
format

Gibt ein Formatobjekt zurück, das die Schriftart des Bereichs, Füllung, den Rahmen, die Ausrichtung und andere Eigenschaften verschachtelt.
formulas

Stellt die Formel in der A1-Schreibweise dar. Wenn eine Zelle keine Formel enthält, wird stattdessen ihr Wert zurückgegeben.
formulasLocal

Stellt die Formel in der A1-Schreibweise, Sprache des Benutzers und im Gebietsschema der Zahlenformatierung 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.
numberFormat

Stellt den Zahlenformatcode von Excel für den angegebenen Bereich dar. Weitere Informationen zur Excel-Zahlenformatierung finden Sie unter Zahlenformatcodes.
rowCount

Gibt die Anzahl der Zeilen im Bereich zurück.
rowIndex

Gibt die Spaltenanzahl der ersten Zelle im Bereich zurück. Nullindiziert.
text

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.
values

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.
valueTypes

Gibt den Datentyp in jeder Zelle an.

Details zur Eigenschaft

address

Gibt den Bereichsverweis im A1-Stil an. Der Adresswert enthält den Blattverweis (z. B. "Sheet1! A1:B4").

address?: string;

Eigenschaftswert

string

Hinweise

[ API-Satz: ExcelApi 1.1 ]

addressLocal

Stellt den Bereichsverweis für den angegebenen Bereich in der Sprache des Benutzers dar.

addressLocal?: string;

Eigenschaftswert

string

Hinweise

[ API-Satz: ExcelApi 1.1 ]

cellCount

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?: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: ExcelApi 1.1 ]

columnCount

Gibt die Gesamtanzahl der Spalten im Bereich an.

columnCount?: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: ExcelApi 1.1 ]

columnIndex

Gibt die Spaltennummer der ersten Zelle im Bereich an. Nullindiziert.

columnIndex?: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: ExcelApi 1.1 ]

format

Gibt ein Formatobjekt zurück, das die Schriftart des Bereichs, Füllung, den Rahmen, die Ausrichtung und andere Eigenschaften verschachtelt.

format?: Excel.Interfaces.RangeFormatData;

Eigenschaftswert

Excel.Interfaces.RangeFormatData

Hinweise

[ API-Satz: ExcelApi 1.1 ]

formulas

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

formulas?: any[][];

Eigenschaftswert

any[][]

Hinweise

[ API-Satz: ExcelApi 1.1 ]

formulasLocal

Stellt die Formel in der A1-Schreibweise, Sprache des Benutzers und im Gebietsschema der Zahlenformatierung 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?: any[][];

Eigenschaftswert

any[][]

Hinweise

[ API-Satz: ExcelApi 1.1 ]

numberFormat

Stellt den Zahlenformatcode von Excel für den angegebenen Bereich dar. Weitere Informationen zur Excel-Zahlenformatierung finden Sie unter Zahlenformatcodes.

numberFormat?: any[][];

Eigenschaftswert

any[][]

Hinweise

[ API-Satz: ExcelApi 1.1 ]

rowCount

Gibt die Anzahl der Zeilen im Bereich zurück.

rowCount?: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: ExcelApi 1.1 ]

rowIndex

Gibt die Spaltenanzahl der ersten Zelle im Bereich zurück. Nullindiziert.

rowIndex?: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: ExcelApi 1.1 ]

text

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?: string[][];

Eigenschaftswert

string[][]

Hinweise

[ API-Satz: ExcelApi 1.1 ]

values

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?: any[][];

Eigenschaftswert

any[][]

Hinweise

[ API-Satz: ExcelApi 1.1 ]

valueTypes

Gibt den Datentyp in jeder Zelle an.

valueTypes?: Excel.RangeValueType[][];

Eigenschaftswert

Excel.RangeValueType[][]

Hinweise

[ API-Satz: ExcelApi 1.1 ]