TableRow erstellenCreate TableRow

Namespace: Microsoft. GraphNamespace: microsoft.graph

Fügt Zeilen am Ende der Tabelle hinzu.Adds rows to the end of the table. Beachten Sie, dass die API mehrere Zeilendaten mithilfe dieser API akzeptieren kann.Note that the API can accept multiple rows data using this API. Das gleichzeitige Hinzufügen einer Zeile kann zu Leistungseinbußen führen.Adding one row at a time could lead to performance degradation. Die empfohlene Vorgehensweise besteht darin, die Zeilen in einem einzigen Aufruf Batch zu stapeln, statt eine Einfügung in einer Zeile durchführen zu müssen.The recommended approach would be to batch the rows together in a single call rather than doing single row insertion. Um optimale Ergebnisse zu erzielen, sammeln Sie die Zeilen, die auf der Anwendungsseite eingefügt werden sollen, und führen Sie den Vorgang zum Hinzufügen einzelner Zeilen durch.For best results, collect the rows to be inserted on the application side and perform single rows add operation. Experimentieren Sie mit der Anzahl der Zeilen, um die ideale Anzahl von Zeilen zu bestimmen, die in einem einzigen API-Aufruf verwendet werden sollen.Experiment with the number of rows to determine the ideal number of rows to use in single API call.

FehlerbehandlungError Handling

Bei dieser Anforderung tritt gelegentlich der 504 HTTP-Fehler auf.This request might occasionally receive a 504 HTTP error. Sollte dieser Fehler auftreten, wiederholen Sie die Anforderung.The appropriate response to this error is to repeat the request.

BerechtigungenPermissions

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.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) Files.ReadWriteFiles.ReadWrite
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Nicht unterstütztNot supported.
AnwendungApplication Nicht unterstütztNot supported.

HTTP-AnforderungHTTP request

POST /workbook/tables/{id|name}/rows/add
POST /workbook/worksheets/{id|name}/tables/{id|name}/rows/add

AnforderungsheaderRequest headers

NameName BeschreibungDescription
AuthorizationAuthorization Bearer {token}. Erforderlich.Bearer {token}. Required.
Arbeitsmappensitzungs-IDWorkbook-Session-Id Arbeitsmappensitzungs-ID, die bestimmt, ob Änderungen beibehalten werden. Optional.Workbook session Id that determines if changes are persisted or not. Optional.

AnforderungstextRequest body

Geben Sie im Anforderungstext ein JSON-Objekt mit den folgenden Parametern an.In the request body, provide a JSON object with the following parameters.

ParameterParameter TypType BeschreibungDescription
Indexindex numbernumber 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.Optional. Specifies the relative position of the new row. If null, the addition happens at the end. Any rows below the inserted row are shifted downwards. Zero-indexed.
valuesvalues JsonJson Ein zweidimensionales Array mit unformatierten Werten der Tabellenzeilen (Boolean oder String oder Number).A 2-dimensional array of unformatted values of the table rows (boolean or string or number).

AntwortResponse

Wenn die Methode erfolgreich verläuft, werden der Antwortcode 200 OK und das TableRow-Objekt im Antworttext zurückgegeben.If successful, this method returns 200 OK response code and TableRow object in the response body.

BeispielExample

In diesem Beispiel werden am Ende der Tabelle zwei Zeilen mit Daten eingefügt.In this example two rows of data are inserted at the end of the table.

AnforderungRequest

Nachfolgend sehen Sie ein Beispiel der Anforderung.Here is an example of the request.

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

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

Nachfolgend sehen Sie ein Beispiel der Antwort. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

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

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