Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 Block von Zellen.
Methoden
| Methode | Rückgabetyp | Beschreibung |
|---|---|---|
| Get | workbookRange | Lesen der Eigenschaften und Beziehungen eines Bereichsobjekts. |
| Update | workbookRange | Aktualisieren eines Bereichsobjekts. |
| Löschen | Keine | Löschen Sie die Zellen, die dem Bereich zugeordnet sind. |
| Clear | None | Löschen Sie Bereichswerte, Format, Füllung oder Rahmen. |
| Boundingrect abrufen | workbookRange | Abrufen des kleinsten Bereichsobjekts, das die angegebenen Bereiche umfasst. Beispielsweise das GetBoundingRect von "B2:C5" und "D10:E15" lautet "B2:E16". |
| Zelle abrufen | workbookRange | Abrufen des Bereichsobjekts, das die einzelne Zelle enthält, basierend auf Zeilen- und Spaltennummern. Die Zelle kann sich außerhalb der Grenzen des übergeordneten Bereichs befinden, solange sie innerhalb des Arbeitsblattrasters bleibt. Die zurückgegebene Zelle befindet sich relativ zur obersten linken Zelle des Bereichs. |
| Spalte abrufen | workbookRange | Abrufen einer Spalte in dem Bereich. |
| Abrufen von Spalten nach | workbookRangeView | Abrufen einiger Spalten rechts vom angegebenen Bereich. |
| Abrufen von Spalten vor | workbookRangeView | Abrufen einiger Spalten links vom angegebenen Bereich. |
| Abrufen der gesamten Spalte | workbookRange | Abrufen eines Objekts, das die gesamte Spalte des Bereichs darstellt. |
| Abrufen der gesamten Zeile | workbookRange | Abrufen eines Objekts, das die gesamte Zeile des Bereichs darstellt. |
| Schnittpunkt abrufen | workbookRange | Rufen Sie das Bereichsobjekt ab, das den rechteckigen Schnittpunkt der angegebenen Bereiche darstellt. |
| Letzte Zelle abrufen | workbookRange | Abrufen der letzten Zelle innerhalb des Bereichs. Beispielsweise lautet die letzte Zelle des Bereichs „B2: D5“ „D5“. |
| Letzte Spalte abrufen | workbookRange | Abrufen der letzten Spalte innerhalb des Bereichs. 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". |
| Offsetbereich abrufen | workbookRange | Ruft ein Objekt ab, das einen Bereich darstellt, der versetzt vom angegebenen Bereich liegt. 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. |
| Größenänderungsbereich abrufen | workbookRangeView | Sie erhalten ein Bereichsobjekt, das dem aktuellen Bereichsobjekt ähnelt, aber mit einer vergrößerten (oder verkleinerten) unteren rechten Ecke um eine bestimmte Anzahl von Zeilen und Spalten. |
| Zeile abrufen | workbookRange | Abrufen einer Zeile im Bereich. |
| Abrufen von Zeilen über | workbookRangeView | Abrufen einiger Zeilen über einem bestimmten Bereich. |
| Abrufen von Zeilen unter | workbookRangeView | Abrufen einiger Zeilen unterhalb eines bestimmten Bereichs. |
| 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 verschieben Sie 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 Bereichsbezug im A1-Format dar. Der Adresswert enthält den Arbeitsblattbezug (z. B. Tabelle1! 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 | Boolean | 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 | Boolean | 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 Zellenbreite ab. Das Ersetzen des #-Zeichens, das 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 sind: 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 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 veranschaulicht 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"
}