Range-RessourcentypRange resource type

Ein Bereich stellt einen Satz von einer oder mehrerer zusammenhängender Zellen wie z. B. eine Zelle, eine Zeile oder eine Spalte, ein Block von Zellen usw. dar.Range represents a set of one or more contiguous cells such as a cell, a row, a column, block of cells, etc.

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
Range abrufenGet Range RangeRange Dient zum Lesen der Eigenschaften und der Beziehungen des range-Objekts.Read properties and relationships of range object.
UpdateUpdate RangeRange Dient zum Aktualisiren des Range-Objekts.Update Range object.
BoundingrectBoundingrect RangeRange Ruft das kleinste Bereichsobjekt ab, das die angegebenen Bereiche umfasst. Beispielsweise das GetBoundingRect von "B2:C5" und "D10:E15" lautet "B2:E16".Gets the smallest range object that encompasses the given ranges. For example, the GetBoundingRect of "B2:C5" and "D10:E15" is "B2:E16".
CellCell RangeRange Ruft das Bereichsobjekt ab, das die einzelne Zelle basierend auf Zeilen- und Spaltenanzahl enthält. Die Zelle kann sich außerhalb seines übergeordneten Bereichs befinden, solange es im Arbeitsblatt-Raster bleibt. Die zurückgegebene Zelle befindet sich relativ zur obersten linken Zelle des Bereichs.Gets the range object containing the single cell based on row and column numbers. The cell can be outside the bounds of its parent range, so long as it's stays within the worksheet grid. The returned cell is located relative to the top left cell of the range.
ColumnColumn RangeRange Ruft eine Spalte ab, die im Bereich enthalten ist.Gets a column contained in the range.
ColumnsafterColumnsafter workbookRangeViewworkbookRangeView collection Ruft eine bestimmte Anzahl von Spalten rechts vom gegebenen Bereich ab.Gets a certain number of columns to the right of the given range.
ColumnsbeforeColumnsbefore workbookRangeViewworkbookRangeView collection Ruft eine bestimmte Anzahl von Spalten links vom gegebenen Bereich ab.Gets a certain number of columns to the left of the given range.
EntirecolumnEntirecolumn RangeRange Ruft ein Objekt ab, das die gesamte Spalte des Bereichs darstellt.Gets an object that represents the entire column of the range.
EntirerowEntirerow RangeRange Ruft ein Objekt ab, das die gesamte Zeile des Bereichs darstellt.Gets an object that represents the entire row of the range.
IntersectionIntersection RangeRange Ruft das Bereichsobjekt ab, das die rechteckige Schnittmenge der angegebenen Bereiche darstellt.Gets the range object that represents the rectangular intersection of the given ranges.
LastcellLastcell RangeRange Ruft die letzte Zelle im Bereich ab. Beispielsweise lautet die letzte Zelle des Bereichs „B2: D5“ „D5“.Gets the last cell within the range. For example, the last cell of "B2:D5" is "D5".
LastcolumnLastcolumn RangeRange Ruft die letzte Spalte im Bereich ab. Beispielsweise lautet die letzte Spalte von „B2:D5“ „D2:D5“.Gets the last column within the range. For example, the last column of "B2:D5" is "D2:D5".
LastrowLastrow RangeRange Ruft die letzte Zeile im Bereich ab. Beispielsweise lautet die letzte Zelle des Bereichs "B2: D5" "B5:D5".Gets the last row within the range. For example, the last row of "B2:D5" is "B5:D5".
OffsetrangeOffsetrange RangeRange Ruft ein Objekt ab, das einen Bereich darstellt, der aus dem angegebenen Bereich versetzt ist. Die Dimension des zurückgegebenen Bereichs entspricht diesem Bereich. Wenn der resultierende Bereich außerhalb des Arbeitsblatt-Rasters erzwungen wird, wird eine Ausnahme ausgelöst.Gets an object which represents a range that's offset from the specified range. The dimension of the returned range will match this range. If the resulting range is forced outside the bounds of the worksheet grid, an exception will be thrown.
RowRow RangeRange Ruft eine Zelle ab, die im Bereich enthalten ist.Gets a row contained in the range.
RowsaboveRowsabove workbookRangeViewworkbookRangeView collection Ruft eine bestimmte Anzahl von Zeilen oberhalb eines gegebenen Bereichs ab.Gets a certain number of rows above a given range.
RowsbelowRowsbelow workbookRangeViewworkbookRangeView collection Ruft eine bestimmte Anzahl von Zeilen unterhalb eines gegebenen Bereichs ab.Gets a certain number of rows below a given range.
UsedrangeUsedrange RangeRange Gibt den verwendeten Bereich des angegebenen Bereichsobjekts zurück.Returns the used range of the given range object.
ClearClear NoneNone Löscht Bereichswerte, Format, Füllung, Rahmen usw.Clear range values, format, fill, border, etc.
LöschenDelete NoneNone Löscht die dem Bereich zugeordneten Zellen.Deletes the cells associated with the range.
InsertInsert RangeRange Fügt eine Zelle oder einen Zellbereich in das Arbeitsblatt anstelle dieses Bereichs ein, und verschiebt die anderen Zellen, um Platz zu schaffen. Gibt ein neues Bereichsobjekt in dem nun leeren Bereich zurück.Inserts a cell or a range of cells into the worksheet in place of this range, and shifts the other cells to make space. Returns a new Range object at the now blank space.
MergeMerge NoneNone Führt die Zellen des Bereichs in eine Region im Arbeitsblatt zusammen.Merge the range cells into one region in the worksheet.
ResizedrangeResizedrange workbookRangeViewworkbookRangeView collection Ruft ein Range-Objekt ähnlich dem aktuellen Range-Objekt ab, dessen untere rechte Ecke jedoch um eine bestimmte Anzahl von Zeilen und Spalten erweitert (oder verkleinert) ist.Gets a range object similar to the current range object, but with its bottom-right corner expanded (or contracted) by some number of rows and columns.
UnmergeUnmerge NoneNone Hebt den Zellverbund des Bereichs in einzelne Zellen auf.Unmerge the range cells into separate cells.
VisibleviewVisibleview workbookRangeViewworkbookRangeView collection Ruft den in einem gefilterten Bereich sichtbaren Bereich ab.Get the range visible from a filtered range.

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
addressaddress stringstring Entspricht dem Bereichsverweis in A1-Schreibweise. Adresswert für den Blattbezug (z. B. Tabelle1!A1:B4). Schreibgeschützt.Represents the range reference in A1-style. Address value will contain the Sheet reference (e.g. Sheet1!A1:B4). Read-only.
addressLocaladdressLocal stringstring Stellt den Bereichsbezug für den angegebenen Bereich in der Sprache des Benutzers dar. Schreibgeschützt.Represents range reference for the specified range in the language of the user. Read-only.
cellCountcellCount intint Anzahl der Zellen im Bereich. Schreibgeschützt.Number of cells in the range. Read-only.
columnCountcolumnCount intint Stellt die Gesamtanzahl der Spalten im Bereich dar. Schreibgeschützt.Represents the total number of columns in the range. Read-only.
columnHiddencolumnHidden booleanboolean Stellt dar, ob alle Spalten des aktuellen Bereichs ausgeblendet sind.Represents if all columns of the current range are hidden.
columnIndexColumnIndex intint Stellt die Spaltenanzahl der ersten Zelle im Bereich dar. Nullindiziert. Schreibgeschützt.Represents the column number of the first cell in the range. Zero-indexed. Read-only.
formulasformulas JsonJson Stellt die Formel in der A1-Schreibweise dar.Represents the formula in A1-style notation.
formulasLocalformulasLocal JsonJson 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.Represents the formula in A1-style notation, in the user's language and number-formatting locale. For example, the English "=SUM(A1, 1.5)" formula would become "=SUMME(A1; 1,5)" in German.
formulasR1C1formulasR1C1 JsonJson Stellt die Formel in der R1C1-Schreibweise dar.Represents the formula in R1C1-style notation.
hiddenhidden booleanboolean Stellt dar, ob alle Zellen des aktuellen Bereichs ausgeblendet sind. Schreibgeschützt.Represents if all cells of the current range are hidden. Read-only.
numberFormatnumberFormat JsonJson Stellt den Excel-Zahlenformatcode für die angegebene Zelle dar.Represents Excel's number format code for the given cell.
rowCountrowCount intint Gibt die Anzahl der Zeilen im Bereich zurück. Schreibgeschützt.Returns the total number of rows in the range. Read-only.
rowHiddenrowHidden booleanboolean Stellt dar, ob alle Zeilen des aktuellen Bereichs ausgeblendet sind.Represents if all rows of the current range are hidden.
rowIndexrowIndex intint Gibt die Spaltenanzahl der ersten Zelle im Bereich zurück. Nullindiziert. Schreibgeschützt.Returns the row number of the first cell in the range. Zero-indexed. Read-only.
texttext JsonJson Textwerte des angegebenen Bereichs. Der Textwert hängt nicht von der Zellenbreite ab. Die Ersetzung des #-Zeichens, die in der Excel-Benutzeroberfläche passiert, wirkt sich nicht auf den von der API zurückgegebenen Textwert aus. Schreibgeschützt.Text values of the specified range. The Text value will not depend on the cell width. The # sign substitution that happens in Excel UI will not affect the text value returned by the API. Read-only.
valueTypesvalueTypes JsonJson Stellt den Datentyp in jeder Zelle dar.Represents the type of data of each cell. Mögliche Werte sind: Unknown, Empty, String, Integer, Double, Boolean, Error.The possible values are: Unknown, Empty, String, Integer, Double, Boolean, Error. Schreibgeschützt.Read-only.
valuesvalues JsonJson Stellt die Rohwerte des angegebenen Bereichs dar. Die zurückgegebenen Daten können den Typ Zeichenfolge, Zahl oder ein boolescher Wert sein. Zelle, die einen Fehler enthalten, geben die Fehlerzeichenfolge zurück.Represents the raw values of the specified range. The data returned could be of type string, number, or a boolean. Cell that contain an error will return the error string.

BeziehungenRelationships

BeziehungRelationship TypType BeschreibungDescription
formatformat WorkbookRangeFormatWorkbookRangeFormat Gibt ein Formatobjekt zurück, das die Schriftart des Bereichs, Füllung, den Rahmen, die Ausrichtung und andere Eigenschaften verschachtelt. Schreibgeschützt.Returns a format object, encapsulating the range's font, fill, borders, alignment, and other properties. Read-only.
sortsort WorkbookRangeSortWorkbookRangeSort Das Arbeitsblatt, das den aktuellen Bereich enthält. Schreibgeschützt.The worksheet containing the current range. Read-only.
Arbeitsblattworksheet WorkbookWorksheetWorkbookWorksheet Das Arbeitsblatt, das den aktuellen Bereich enthält.The worksheet containing the current range. Schreibgeschützt.Read-only.

JSON-DarstellungJSON representation

Es folgt eine JSON-Darstellung der Ressource.Here is a JSON representation of the resource.

{
  "address": "string",
  "addressLocal": "string",
  "cellCount": 1024,
  "columnCount": 1024,
  "columnHidden": true,
  "columnIndex": 1024,
  "formulas": "json",
  "formulasLocal": "json",
  "formulasR1C1": "json",
  "hidden": true,
  "numberFormat": "json",
  "rowCount": 1024,
  "rowHidden": true,
  "rowIndex": 1024,
  "text": "json",
  "valueTypes": "string",
  "values": "json"
}