Arbeitsblatt: UsedRange

Der verwendete Bereich ist der kleinste Bereich, der mindestens eine der Zellen umfasst, die einen Wert enthalten oder denen eine Formatierung zugewiesen wurde. Wenn das Arbeitsblatt leer ist, gibt diese Funktion die oberste linke Zelle zurück.

Voraussetzungen

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

* Files.ReadWrite

HTTP-Anforderung

GET /workbook/worksheets/{id|name}/UsedRange

Optionaler Anforderungsparameter

Stellen Sie in der Anforderungs-URL einen optionalen Abfrageparameter bereit.

Parameter Typ Beschreibung
valuesOnly Boolescher Wert Optional. Betrachtet nur Zellen mit Werten als verwendet (ignoriert die Formatierung).

Anforderungsheader

Name Beschreibung
Authorization Bearer {code}

Antwort

Wenn die Methode erfolgreich verläuft, werden der Antwortcode 200, OK und das Range-Objekt im Antworttext zurückgegeben.

Beispiel

Nachfolgend sehen Sie ein Beispiel dafür, wie diese API aufgerufen wird.

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

GET https://graph.microsoft.com/v1.0/me/drive/items/{id}/workbook/worksheets/{id|name}/UsedRange(valuesOnly=true)
Content-type: application/json

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 200 OK
Content-type: application/json
Content-length: 169

{
  "address": "address-value",
  "addressLocal": "addressLocal-value",
  "cellCount": 99,
  "columnCount": 99,
  "columnIndex": 99,
  "valueTypes": "valueTypes-value"
}