Beachten Sie, dass diese API mehrere Datenzeilen akzeptieren kann. Das Hinzufügen einer Zeile nach der anderen kann sich auf die Leistung auswirken. Der empfohlene Ansatz besteht darin, die Zeilen in einem einzigen Aufruf zusammenzusammeln, anstatt einzelne Zeilen einzufügen. Um optimale Ergebnisse zu erzielen, sammeln Sie die Zeilen, die auf der Anwendungsseite eingefügt werden sollen, und führen Sie einen einzelnen Vorgang zum Hinzufügen einer Zeile aus. Experimentieren Sie mit der Anzahl der Zeilen, um die ideale Anzahl von Zeilen zu ermitteln, die in einem einzelnen API-Aufruf verwendet werden sollen.
Diese Anforderung kann gelegentlich zu einem 504 HTTP Fehler führen. Sollte dieser Fehler auftreten, wiederholen Sie die Anforderung.
Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
Berechtigungstyp
Berechtigungen mit den geringsten Berechtigungen
Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto)
Files.ReadWrite
Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto)
Nicht unterstützt
Nicht unterstützt
Anwendung
Nicht unterstützt
Nicht unterstützt
HTTP-Anforderung
POST /me/drive/items/{id}/workbook/tables/{id|name}/rows
POST /me/drive/root:/{item-path}:/workbook/tables/{id|name}/rows
POST /me/drive/items/{id}/workbook/worksheets/{id|name}/tables/{id|name}/rows
POST /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/tables/{id|name}/rows
respond-async. Gibt an, dass es sich bei der Anforderung um eine asynchrone Anforderung handelt. Optional.
Arbeitsmappensitzungs-ID
{Workbook-Session-ID}. Erstellt aus der createSession-Anforderung . Optional.
Anforderungstext
Geben Sie im Anforderungstext ein JSON-Objekt mit den folgenden Parametern an.
Parameter
Typ
Beschreibung
Index
Int32
Optional. Gibt die relative Position der neuen Zeile an. Bei Null erfolgt die Erweiterung am Ende. Alle Zeilen unterhalb der eingefügten Zeile werden nach unten verschoben. Nullindiziert.
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new WorkbookTableRow
{
Values = new List<List<Number>>
{
new List<Number>
{
1,
2,
3,
},
new List<Number>
{
4,
5,
6,
},
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Drives["{drive-id}"].Items["{driveItem-id}"].Workbook.Tables["{workbookTable-id}"].Rows.PostAsync(requestBody);
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
WorkbookTableRow workbookTableRow = new WorkbookTableRow();
LinkedList<LinkedList<Number>> values = new LinkedList<LinkedList<Number>>();
LinkedList<Number> json = new LinkedList<Number>();
json.add(1);
json.add(2);
json.add(3);
values.add(json);
LinkedList<Number> json1 = new LinkedList<Number>();
json1.add(4);
json1.add(5);
json1.add(6);
values.add(json1);
workbookTableRow.setValues(values);
WorkbookTableRow result = graphClient.drives().byDriveId("{drive-id}").items().byDriveItemId("{driveItem-id}").workbook().tables().byWorkbookTableId("{workbookTable-id}").rows().post(workbookTableRow);
Beispiel 2: asynchrones Hinzufügen von zwei Zeilen zu einer Tabelle
Asynchrone Anforderungen sind nützlich, wenn die Anforderung länger dauert als erwartet. Beachten Sie, dass der Workbook-Session-Id Header erforderlich ist, wenn asynchrone Anforderungen ausgegeben werden. Der Benutzer muss eine Sitzung erstellen, bevor er asynchrone rich-API-Features verwendet. Der -Header Prefer:respond-async ist auch in den asynchronen Anforderungen erforderlich.
Hier sehen Sie ein Beispiel für die asynchrone Anforderung. Beachten Sie, dass 202 Accepted nur auftritt, wenn die Antwort der Anforderung sehr lange dauert. Wenn die Anforderung schnell abgeschlossen wird, funktioniert sie wie eine normale Synchronisierungsanforderung, die auf Beispiel 1 zurückfällt.
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new WorkbookTableRow
{
Values = new List<List<Number>>
{
new List<Number>
{
1,
2,
3,
},
new List<Number>
{
4,
5,
6,
},
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Drives["{drive-id}"].Items["{driveItem-id}"].Workbook.Tables["{workbookTable-id}"].Rows.PostAsync(requestBody, (requestConfiguration) =>
{
requestConfiguration.Headers.Add("Prefer", "respond-async");
requestConfiguration.Headers.Add("Workbook-Session-Id", "{Workbook-Session-Id}");
});
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
WorkbookTableRow workbookTableRow = new WorkbookTableRow();
LinkedList<LinkedList<Number>> values = new LinkedList<LinkedList<Number>>();
LinkedList<Number> json = new LinkedList<Number>();
json.add(1);
json.add(2);
json.add(3);
values.add(json);
LinkedList<Number> json1 = new LinkedList<Number>();
json1.add(4);
json1.add(5);
json1.add(6);
values.add(json1);
workbookTableRow.setValues(values);
WorkbookTableRow result = graphClient.drives().byDriveId("{drive-id}").items().byDriveItemId("{driveItem-id}").workbook().tables().byWorkbookTableId("{workbookTable-id}").rows().post(workbookTableRow, requestConfiguration -> {
requestConfiguration.headers.add("Prefer", "respond-async");
requestConfiguration.headers.add("Workbook-Session-Id", "{Workbook-Session-Id}");
});
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 unter https://aka.ms/ContentUserFeedback.