Tabelle erstellen

Verwenden Sie diese API zum Erstellen einer neuen Tabelle.

Voraussetzungen

Die folgenden Bereiche sind erforderlich, um diese API auszuführen:

* Files.ReadWrite

HTTP-Anforderung

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

Anforderungsheader

Name Beschreibung
Authorization Bearer {code}

Anforderungstext

Geben Sie im Anforderungstext die folgenden Parameter an.

Anforderungsparameter

Name Typ Beschreibung
Address string Bereichsadresse. Wenn Sie diese API abseits des worksheets/{id or name}/tables/add-Pfads aufrufen, müssen Sie das Präfix für den Blattnamen nicht in der Adresse angeben. Wenn Sie diese jedoch abseits des workbook/tables/add-Pfads aufrufen, müssen Sie den Blattnamen angeben, auf dem die Tabelle erstellt werden muss (Beispiel: sheet1!A1:D4)
hasHeaders Boolescher Wert Boolescher Wert, der angibt, ob der Bereich Spaltenbeschriftungen hat. Wenn die Quelle keine Überschriften enthält (d. h. wenn diese Eigenschaft auf „false“ festgelegt ist), generiert Excel automatisch eine Überschriftenänderung der Daten nach einer Zeile.

Antwort

Wenn die Methode erfolgreich verläuft, werden der Antwortcode 201, Created und das Table-Objekt im Antworttext zurückgegeben.

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

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

{
  "address": "A1:D8",
  "hasHeaders": false
}
Antwort

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.

HTTP/1.1 201 Created
Content-type: application/json
Content-length: 109

{
  "id": "99",
  "name": "name-value",
  "showHeaders": true,
  "showTotals": true,
  "style": "style-value"
}