workbookRange-Ressourcentyp

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Stellt eine Gruppe von einer oder mehreren zusammenhängenden Zellen in einer Arbeitsmappe dar, z. B. eine Zelle, eine Zeile, eine Spalte oder einen Zellblock.

Methoden

Methode	Rückgabetyp	Beschreibung
Get	workbookRange	Liest die Eigenschaften und Beziehungen eines Bereichsobjekts.
Update	workbookRange	Aktualisieren eines Bereichsobjekts.
Delete	Keine	Löschen Sie die dem Bereich zugeordneten Zellen.
Clear	None	Löschen Sie Bereichswerte, Format, Füllung oder Rahmen.
Boundingrect abrufen	workbookRange	Ruft das kleinste Bereichsobjekt ab, das die angegebenen Bereiche umfasst. Beispielsweise das GetBoundingRect von "B2:C5" und "D10:E15" lautet "B2:E16".
Zelle abrufen	workbookRange	Ruft das Bereichsobjekt ab, das die einzelne Zelle basierend auf Zeilen- und Spaltennummern enthält. Die Zelle kann sich außerhalb der Grenzen ihres übergeordneten Bereichs befinden, solange sie im Arbeitsblattraster verbleibt. Die zurückgegebene Zelle befindet sich relativ zur obersten linken Zelle des Bereichs.
Spalte abrufen	workbookRange	Ruft eine Spalte ab, die im Bereich enthalten ist.
Abrufen von Spalten nach	workbookRangeView	Ruft einige Spalten rechts neben dem angegebenen Bereich ab.
Abrufen von Spalten vor	workbookRangeView	Ruft einige Spalten links vom angegebenen Bereich ab.
Abrufen der gesamten Spalte	workbookRange	Ruft ein -Objekt ab, das die gesamte Spalte des Bereichs darstellt.
Abrufen der gesamten Zeile	workbookRange	Ruft ein Objekt ab, das die gesamte Zeile des Bereichs darstellt.
Schnittmenge abrufen	workbookRange	Ruft das Bereichsobjekt ab, das den rechteckigen Schnittpunkt der angegebenen Bereiche darstellt.
Letzte Zelle abrufen	workbookRange	Ruft die letzte Zelle innerhalb des Bereichs ab. Beispielsweise lautet die letzte Zelle des Bereichs „B2: D5“ „D5“.
Letzte Spalte abrufen	workbookRange	Ruft die letzte Spalte innerhalb des Bereichs ab. Beispielsweise lautet die letzte Spalte von „B2:D5“ „D2:D5“.
Letzte Zeile abrufen	workbookRange	Ruft die letzte Zeile innerhalb des Bereichs ab. Beispielsweise lautet die letzte Zelle des Bereichs "B2: D5" "B5:D5".
Abrufen des Offsetbereichs	workbookRange	Rufen Sie ein Objekt ab, das einen Bereich darstellt, der vom 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.
Abrufen eines Bereichs mit geänderter Größe	workbookRangeView	Rufen Sie ein Bereichsobjekt ab, das dem aktuellen Bereichsobjekt ähnelt, aber mit dessen unteren rechten Ecke um eine bestimmte Anzahl von Zeilen und Spalten erweitert (oder kontrahiert) wird.
Zeile abrufen	workbookRange	Ruft eine Zeile ab, die im Bereich enthalten ist.
Abrufen von Zeilen über	workbookRangeView	Ruft einige Zeilen oberhalb eines angegebenen Bereichs ab.
Abrufen von Zeilen unter	workbookRangeView	Ruft einige Zeilen unterhalb eines angegebenen Bereichs ab.
Abrufen des verwendeten Bereichs	workbookRange	Gibt den verwendeten Bereich des angegebenen Bereichsobjekts zurück.
Abrufen der sichtbaren Ansicht	workbookRangeView	Ruft den in einem gefilterten Bereich sichtbaren Bereich ab.
Bereich einfügen	workbookRange	Fügen Sie eine Zelle oder einen Zellbereich anstelle dieses Bereichs in das Arbeitsblatt ein, und verschiebt die anderen Zellen, um Platz zu schaffen. Gibt ein neues Bereichsobjekt in dem nun leeren Bereich zurück.
Merge	None	Führt die Zellen des Bereichs in einen Bereich im Arbeitsblatt zusammen.
Unmerge	None	Hebt den Zellverbund des Bereichs in einzelne Zellen auf.

Eigenschaften

Eigenschaft	Typ	Beschreibung
address	string	Stellt den Bereichsverweis im A1-Format dar. Der Adresswert enthält den Blattverweis (z. B. Sheet1! A1:B4). Schreibgeschützt.
addressLocal	string	Stellt den Bereichsbezug für den angegebenen Bereich in der Sprache des Benutzers dar. Schreibgeschützt.
cellCount	int	Anzahl der Zellen im Bereich. Schreibgeschützt.
columnCount	int	Stellt die Gesamtanzahl der Spalten im Bereich dar. Schreibgeschützt.
columnHidden	Boolesch	Gibt an, ob alle Spalten des aktuellen Bereichs ausgeblendet sind.
columnIndex	int	Stellt die Spaltenanzahl der ersten Zelle im Bereich dar. Nullindiziert. Schreibgeschützt.
formulas	Json	Stellt die Formel in der A1-Schreibweise dar.
formulasLocal	Json	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.
formulasR1C1	Json	Stellt die Formel in der R1C1-Schreibweise dar.
hidden	boolean	Stellt dar, ob alle Zellen des aktuellen Bereichs ausgeblendet sind. Schreibgeschützt.
numberFormat	Json	Stellt den Excel-Zahlenformatcode für die angegebene Zelle dar.
rowCount	int	Gibt die Anzahl der Zeilen im Bereich zurück. Schreibgeschützt.
rowHidden	Boolesch	Gibt an, ob alle Zeilen des aktuellen Bereichs ausgeblendet sind.
rowIndex	int	Gibt die Spaltenanzahl der ersten Zelle im Bereich zurück. Nullindiziert. Schreibgeschützt.
text	Json	Textwerte des angegebenen Bereichs. Der Textwert hängt nicht von der Zellbreite ab. Die Ersetzung des Zeichens #, die in der Excel-Benutzeroberfläche erfolgt, wirkt sich nicht auf den von der API zurückgegebenen Textwert aus. Schreibgeschützt.
valueTypes	string	Stellt den Datentyp in jeder Zelle dar. Mögliche Werte: Unknown, Empty, String, Integer, Double, Boolean, Error. Schreibgeschützt.
values	Json	Stellt die Rohwerte des angegebenen Bereichs dar. Die zurückgegebenen Daten können vom Typ Zeichenfolge, Zahl oder ein boolescher Wert sein. Zelle, die einen Fehler enthält, gibt die Fehlerzeichenfolge zurück.

Beziehungen

Beziehung	Typ	Beschreibung
format	workbookRangeFormat	Gibt ein Formatobjekt zurück, das die Schriftart des Bereichs, Füllung, den Rahmen, die Ausrichtung und andere Eigenschaften verschachtelt. Schreibgeschützt.
sort	workbookRangeSort	Das Arbeitsblatt, das den aktuellen Bereich enthält. Schreibgeschützt.
Arbeitsblatt	workbookWorksheet	Das Arbeitsblatt, das den aktuellen Bereich enthält. Schreibgeschützt.

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

{
  "id": "string",
  "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"
}