Freigeben über

RangeSort: apply

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Führt einen Sortiervorgang aus.

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. 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) Files.ReadWrite Nicht verfügbar.
Application Nicht unterstützt Nicht unterstützt

HTTP-Anforderung

POST /me/drive/items/{id}/workbook/names/{name}/range/sort/apply
POST /me/drive/root:/{item-path}:/workbook/names/{name}/range/sort/apply
POST /me/drive/items/{id}/workbook/worksheets/{id|name}/range(address='<address>')/sort/apply
POST /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/range(address='<address>')/sort/apply
POST /me/drive/items/{id}/workbook/tables/{id|name}/columns/{id|name}/range/sort/apply
POST /me/drive/root:/{item-path}:/workbook/tables/{id|name}/columns/{id|name}/range/sort/apply

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Workbook-Session-ID Arbeitsmappensitzungs-ID, die bestimmt, ob Änderungen beibehalten werden oder nicht. Optional.

Anforderungstext

Geben Sie im Anforderungstext ein JSON-Objekt mit den folgenden Parametern an.

Parameter Typ Beschreibung
fields workbookSortField-Auflistung Die Liste der Bedingungen, nach denen sortiert werden soll.
matchCase Boolescher Wert Optional. Ob die Groß-/Kleinschreibung vorhanden ist, bestimmt die Zeichenfolgenreihenfolge.
hasHeaders Boolescher Wert Optional. Gibt an, ob der Bereich eine Kopfzeile aufweist.
orientation string Optional. Gibt an, ob der Vorgang Zeilen oder Spalten sortiert. Die möglichen Werte sind: Rows, Columns.
Methode string Optional. Die Sortiermethode für chinesische Zeichen. Die möglichen Werte sind: PinYin, StrokeCount.

Antwort

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 200 OK zurückgegeben. Es gibt nichts im Antworttext zurück.

Beispiel

Hier sehen Sie ein Beispiel für das Aufrufen dieser API.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/names/{name}/range/sort/apply
Content-type: application/json

{
  "fields": [
    {
      "key": 99,
      "sortOn": "sortOn-value",
      "ascending": true,
      "color": "color-value",
      "dataOption": "dataOption-value",
      "icon": {
        "set": "set-value",
        "index": 99
      }
    }
  ],
  "matchCase": true,
  "hasHeaders": true,
  "orientation": "orientation-value",
  "method": "method-value"
}
Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 200 OK
  • Last updated on