TableRowCollection: add

Namespace: microsoft.graph

Fügt Zeilen am Ende der Tabelle hinzu. Beachten Sie, dass die API mit dieser API mehrere Zeilendaten akzeptieren kann. Das Gleichzeitige Hinzufügen einer Zeile kann zu leistungsbeeinträchtigungen führen. Der empfohlene Ansatz besteht darin, die Zeilen in einem einzigen Aufruf zu stapeln, anstatt eine einzelne Zeile einzugeben. Um optimale Ergebnisse zu erzielen, sammeln Sie die Zeilen, die auf der Anwendungsseite eingefügt werden sollen, und führen Sie einen Vorgang zum Hinzufügen einzelner Zeilen 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.

Fehlerbehandlung

Bei dieser Anforderung tritt gelegentlich der 504 HTTP-Fehler auf. Sollte dieser Fehler auftreten, wiederholen Sie die Anforderung.

Berechtigungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.

Berechtigungstyp	Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto)	Files.ReadWrite
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt
Anwendung	Nicht unterstützt

HTTP-Anforderung

POST /me/drive/items/{id}/workbook/tables/{id|name}/rows/add
POST /me/drive/root:/{item-path}:/workbook/tables/{id|name}/rows/add
POST /me/drive/items/{id}/workbook/worksheets/{id|name}/tables/{id|name}/rows/add
POST /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/tables/{id|name}/rows/add

Anforderungsheader

Name	Beschreibung
Authorization	Bearer {token}. Erforderlich.
Arbeitsmappensitzungs-ID	Arbeitsmappensitzungs-ID, die bestimmt, ob Änderungen beibehalten werden. 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.
values	Json	Optional. Ein 2-dimensionales Array von unformatierten Werten der Tabellenzeile.

Antwort

Bei erfolgreicher Ausführung gibt die Methode 200 OK den Antwortcode und das WorkbookTableRow-Objekt im Antworttext zurück.

Beispiel

In diesem Beispiel werden zwei Datenzeilen am Ende der Tabelle eingefügt.

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

HTTP

POST https://graph.microsoft.com/v1.0/me/drive/items/{id}/workbook/tables/{id|name}/rows/add
Content-type: application/json

{
  "index": 5,
  "values": [
    [1, 2, 3],
    [4, 5, 6]
  ]
}

JavaScript

const options = {
    authProvider,
};

const client = Client.init(options);

const workbookTableRow = {
  index: 5,
  values: [
    [1, 2, 3],
    [4, 5, 6]
  ]
};

await client.api('/me/drive/items/{id}/workbook/tables/{id|name}/rows/add')
    .post(workbookTableRow);

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz finden Sie in der SDK-Dokumentation.

C#

GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var index = 5;

var values = JsonDocument.Parse("[[1,2,3],[4,5,6]]");

await graphClient.Me.Drive.Items["{driveItem-id}"].Workbook.Tables["{workbookTable-id}"].Rows
    .Add(index,values)
    .Request()
    .PostAsync();

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz finden Sie in der SDK-Dokumentation.

Antwort

Hier ist ein Beispiel für die Antwort. Hinweis: Das hier gezeigte Antwortobjekt wird möglicherweise zur besseren Lesbarkeit verkürzt.

HTTP/1.1 200 OK
Content-type: application/json

{
  "index": 99,
  "values": "values-value"
}