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 | Boolesch | 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 string, number oder boolean 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"
}
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für