Arbeiten mit Listen und Listenelementen unter Verwendung von RESTWorking with lists and list items with REST

Tipp

Der REST-Dienst von SharePoint Online (und von lokalem SharePoint 2016 und höher) unterstützt die Kombination mehrerer Anforderungen in einem einzelnen Dienstaufruf mithilfe der OData-Abfrageoption $batch.The SharePoint Online (and on-premises SharePoint 2016 and later) REST service supports combining multiple requests into a single call to the service by using the OData $batch query option. Einzelheiten und Links zu Codebeispielen finden Sie unter Erstellen von Batchanforderungen mit den REST-APIs.For details and links to code samples, see Make batch requests with the REST APIs.

VoraussetzungenPrerequisites

In diesem Artikel setzen wir voraus, dass Sie bereits den Artikel Grundlegendes zum SharePoint-REST-Dienst sowie den Artikel Ausführen grundlegender Vorgänge unter Verwendung von SharePoint-REST-Endpunkten gelesen haben.This topic assumes that you are already familiar with the topics Get to know the SharePoint REST service and Complete basic operations using SharePoint REST endpoints. Es werden keine Codeausschnitte bereitgestellt.It does not provide code snippets.

Abrufen von Listen und Listeneigenschaften mit RESTRetrieving lists and list properties with REST

Das folgende Beispiel zeigt, wie Sie eine bestimmte Liste abrufen, wenn Sie wissen, dass sie GUID ist.The following example shows how to retrieve a specific list if you know its GUID.

url: http://site url/_api/web/lists(guid'list GUID'),
method: GET
Headers:
    Authorization: "Bearer " + accessToken
    accept: "application/json;odata=verbose" or "application/atom+xml"

Hinweis

Verwenden Sie in der accept-Kopfzeile application/json;odata=verbose, wenn Sie die Antwort in JSON wünschen.If you want the response in JSON, use application/json;odata=verbose in the accept header .

Verwenden Sie application/atom+xml in der accept-Kopfzeile, wenn Sie die Antwort im Format Atom wünschen.If you want the response in Atom format, use application/atom+xml in the accept header.


Das folgende Beispiel zeigt, wie Sie eine bestimmte Liste abrufen, wenn ihr Titel bekannt ist.The following example shows how to retrieve a specific list if you know its title.

url: http://site url/_api/web/lists/GetByTitle('Test')
method: GET
Headers:
    Authorization: "Bearer " + accessToken
    accept: "application/json;odata=verbose" or "application/atom+xml"


Der folgende XML-Code zeigt ein Beispiel für die Listeneigenschaften, die beim Anfordern des XML-Inhaltstyps zurückgegeben werden.The following XML shows an example of the list properties that are returned when you request the XML content type.

  <content type="application/xml">
  <m:properties>
  <d:AllowContentTypes m:type="Edm.Boolean">true</d:AllowContentTypes> 
  <d:BaseTemplate m:type="Edm.Int32">100</d:BaseTemplate> 
  <d:BaseType m:type="Edm.Int32">0</d:BaseType> 
  <d:ContentTypesEnabled m:type="Edm.Boolean">false</d:ContentTypesEnabled> 
  <d:Created m:type="Edm.DateTime">2012-06-26T23:15:58Z</d:Created> 
  <d:DefaultContentApprovalWorkflowId m:type="Edm.Guid">00000000-0000-0000-0000-000000000000</d:DefaultContentApprovalWorkflowId> 
  <d:Description>A list created by Project Based Retention used to store Project Policy Items.</d:Description> 
  <d:Direction>none</d:Direction> 
  <d:DocumentTemplateUrl m:null="true" /> 
  <d:DraftVersionVisibility m:type="Edm.Int32">0</d:DraftVersionVisibility> 
  <d:EnableAttachments m:type="Edm.Boolean">true</d:EnableAttachments> 
  <d:EnableFolderCreation m:type="Edm.Boolean">false</d:EnableFolderCreation> 
  <d:EnableMinorVersions m:type="Edm.Boolean">false</d:EnableMinorVersions> 
  <d:EnableModeration m:type="Edm.Boolean">false</d:EnableModeration> 
  <d:EnableVersioning m:type="Edm.Boolean">false</d:EnableVersioning> 
  <d:EntityTypeName>ProjectPolicyItemList</d:EntityTypeName> 
  <d:ForceCheckout m:type="Edm.Boolean">false</d:ForceCheckout> 
  <d:HasExternalDataSource m:type="Edm.Boolean">false</d:HasExternalDataSource> 
  <d:Hidden m:type="Edm.Boolean">true</d:Hidden> 
  <d:Id m:type="Edm.Guid">74de3ff3-029c-42f9-bd2a-1e9463def69d</d:Id> 
  <d:ImageUrl>/_layouts/15/images/itgen.gif</d:ImageUrl> 
  <d:IrmEnabled m:type="Edm.Boolean">false</d:IrmEnabled> 
  <d:IrmExpire m:type="Edm.Boolean">false</d:IrmExpire> 
  <d:IrmReject m:type="Edm.Boolean">false</d:IrmReject> 
  <d:IsApplicationList m:type="Edm.Boolean">false</d:IsApplicationList> 
  <d:IsCatalog m:type="Edm.Boolean">false</d:IsCatalog> 
  <d:IsPrivate m:type="Edm.Boolean">false</d:IsPrivate> 
  <d:ItemCount m:type="Edm.Int32">0</d:ItemCount> 
  <d:LastItemDeletedDate m:type="Edm.DateTime">2012-06-26T23:15:58Z</d:LastItemDeletedDate> 
  <d:LastItemModifiedDate m:type="Edm.DateTime">2012-06-26T23:15:59Z</d:LastItemModifiedDate> 
  <d:ListItemEntityTypeFullName>SP.Data.ProjectPolicyItemListItem</d:ListItemEntityTypeFullName> 
  <d:MultipleDataList m:type="Edm.Boolean">false</d:MultipleDataList> 
  <d:NoCrawl m:type="Edm.Boolean">true</d:NoCrawl> 
  <d:ParentWebUrl>/</d:ParentWebUrl> 
  <d:ServerTemplateCanCreateFolders m:type="Edm.Boolean">true</d:ServerTemplateCanCreateFolders> 
  <d:TemplateFeatureId m:type="Edm.Guid">00bfea71-de22-43b2-a848-c05709900100</d:TemplateFeatureId> 
  <d:Title>Project Policy Item List</d:Title> 
  </m:properties>
  </content>

Hinweis

Die Eigenschaft ListItemEntityTypeFullName (SP.Data.ProjectPolicyItemListItem im vorhergehenden Beispiel) ist wichtig, wenn Sie Listenelemente erstellen und aktualisieren möchten.The ListItemEntityTypeFullName property (SP.Data.ProjectPolicyItemListItem in the previous example) is especially important if you want to create and update list items. Dieser Wert muss als type-Eigenschaft in den Metadaten übergeben werden, die Sie im Textkörper der HTTP-Anforderung übergeben, wenn Sie Listenelemente erstellen und aktualisieren.This value must be passed as the type property in the metadata that you pass in the body of the HTTP request whenever you create and update list items.


Arbeiten mit Listen unter Verwendung von RESTWorking with lists by using REST

Das folgende Beispiel zeigt, wie Sie eine Liste erstellen.The following example shows how to create a list.

url: http://site url/_api/web/lists
method: POST
body: { '__metadata': { 'type': 'SP.List' }, 'AllowContentTypes': true, 'BaseTemplate': 100,
 'ContentTypesEnabled': true, 'Description': 'My list description', 'Title': 'Test' }
Headers: 
    Authorization: "Bearer " + accessToken
    X-RequestDigest: form digest value
    accept: "application/json;odata=verbose"
    content-type: "application/json;odata=verbose"
    content-length:length of post body


Das folgende Beispiel zeigt, wie Sie eine Liste mithilfe der MERGE-Methode aktualisieren..The following example shows how to update a list by using the MERGE method.

url: http://site url/_api/web/lists(guid'list GUID')
method: POST
body: { '__metadata': { 'type': 'SP.List' }, 'Title': 'New title' }
Headers: 
    Authorization: "Bearer " + accessToken
    X-RequestDigest: form digest value
    IF-MATCH": etag or "*"
    X-HTTP-Method: MERGE,
    accept: "application/json;odata=verbose"
    content-type: "application/json;odata=verbose"
    content-length:length of post body


Das folgende Beispiel zeigt, wie Sie ein benutzerdefiniertes Feld für eine Liste erstellen.The following example shows how to create a custom field for a list.

Url: url: http://site url/_api/web/lists(guid'list GUID')/Fields
Method:POST
Body: { '__metadata': { 'type': 'SP.Field' }, 'Title': 'field title', 'FieldTypeKind': FieldType value,'Required': 'true/false', 'EnforceUniqueValues': 'true/false','StaticName': 'field name'}
Headers: 
    Authorization: "Bearer " + accessToken
    X-RequestDigest: form digest value
    content-type: "application/json;odata=verbose"
    content-length:length of post body


Das folgende Beispiel zeigt, wie Sie eine Liste löschen.The following example shows how to delete a list.

url: http://site url/_api/web/lists(guid'list GUID')
method: POST
Headers: 
    Authorization: "Bearer " + accessToken
    X-RequestDigest: form digest value
    IF-MATCH: etag or "*"
    X-HTTP-Method: DELETE


Arbeiten mit Listenelementen unter Verwendung von RESTWorking with list items by using REST

Alle Listenelemente abrufenRetrieve all list items

Das folgende Beispiel zeigt, wie Sie alle Elemente einer Liste abrufen.The following example shows how to retrieve all of a list's items.

Hinweis

Die OData-Abfrageoption „$skip“ funktioniert nicht für das Abfragen von Listenelementen.The OData $skip query option does not work when querying list items. In vielen Fällen können Sie stattdessen die Option $skiptoken verwenden.In may situations, you can use the $skiptoken option instead.

url: http://site url/_api/web/lists/GetByTitle('Test')/items
method: GET
headers:
    Authorization: "Bearer " + accessToken
    accept: "application/json;odata=verbose" or "application/atom+xml"

Ein bestimmtes Listenelement abrufenRetrieve specific list item

Das folgende Beispiel zeigt, wie Sie ein bestimmtes Listenelement abrufen.The following example shows how to retrieve a specific list item.

url: http://site url/_api/web/lists/GetByTitle('Test')/items(item id)
method: GET
headers:
    Authorization: "Bearer " + accessToken
    accept: "application/json;odata=verbose" or "application/atom+xml"


Der folgende XML-Code zeigt ein Beispiel für die Listenelementeigenschaften, die beim Anfordern des XML-Inhaltstyps zurückgegeben werden.The following XML shows an example of the list item properties that are returned when you request the XML content type.

<content type="application/xml">
<m:properties> 
<d:FileSystemObjectType m:type="Edm.Int32">0</d:FileSystemObjectType>
<d:Id m:type="Edm.Int32">1</d:Id>
<d:ID m:type="Edm.Int32">1</d:ID>
<d:ContentTypeId>0x010049564F321A0F0543BA8C6303316C8C0F</d:ContentTypeId>
<d:Title>an item</d:Title>
<d:Modified m:type="Edm.DateTime">2012-07-24T22:47:26Z</d:Modified>
<d:Created m:type="Edm.DateTime">2012-07-24T22:47:26Z</d:Created>
<d:AuthorId m:type="Edm.Int32">11</d:AuthorId>
<d:EditorId m:type="Edm.Int32">11</d:EditorId>
<d:OData__UIVersionString>1.0</d:OData__UIVersionString>
<d:Attachments m:type="Edm.Boolean">false</d:Attachments>
<d:GUID m:type="Edm.Guid">eb6850c5-9a30-4636-b282-234eda8b1057</d:GUID>
</m:properties>
</content>

Elementen als Datenstrom abrufenRetrieve items as a stream

Ruft Informationen über die Liste und ihre Daten ab.Retrieves information about the list and its data. Mit dieser API können Sie Listenelemente in Fällen abrufen, in denen sie komplexe Felder wie Nachschlagevorgänge oder verwaltete Metadaten verwenden.Using this API you can retrieve list items in case they use complex fields such as lookups or managed metadata.

POST /_api/web/GetList(@listUrl)/RenderListDataAsStream?@listUrl=%27%2Fsites%2Fteam-a%2Flists%2FList%27

URI-ParameterURI Parameters

Die folgenden Eigenschaften können als Parameter der Abfragezeichenfolge hinzugefügt werden, um die zurückgegebenen Daten zu bearbeiten.Following properties can be added as query string parameters to manipulate the returned data.

EigenschaftProperty BeschreibungDescription TypType BeispielExample
CascDelWarnMessage Gibt an, ob eine Meldung angezeigt werden soll, wenn es eine Löschweitergabewarnung vorliegtSpecifies if a message should be displayed if there is a cascade deletion warning numbernumber 1
DrillDown Gibt an, dass einige Gruppen in einer gruppierten Ansicht erweitert werden.Specifies that some groups in a grouped view is expanded. Wird mit GroupString verwendet.Used with GroupString. stringstring
GroupString Gruppenbezeichner, der für Drilldownfeature verwendet wird.Group identifier used for drill down feature. stringstring
HasOverrideSelectCommand Wird verwendet, um das Vorhandensein bestimmter Felder sicherzustellen, damit das SharePoint-ListView-Steuerelement ordnungsgemäß funktioniert.Used to ensure that certain fields are present for proper functioning of the SharePoint ListView control. stringstring
Field Gibt ein spezielles Feld an, das eingeschlossen werden sollen.Specifies a special field that should be included. stringstring
FieldInternalName Wird verwendet, um ein Feld zu identifizieren, wenn eine Liste über eine externe Datenquelle verfügt.Used to identify a field when a list has an external data source. Wird auch beim Filtern nach einem benutzerdefinierten Feld verwendet.Also used when filtering on a custom field. stringstring
Filter Gibt an, ob auf die angeforderte Ansicht ein Filter angewendet werden soll.Specifies whether the requested view should have a filter applied. stringstring
FilterData Daten, die durch einen bestimmten Filter angegeben werden.Data specified by a particular filter. stringstring
FilterData1 Daten, die durch einen bestimmten Filter angegeben werden.Data specified by a particular filter. stringstring
FilterData2 Daten, die durch einen bestimmten Filter angegeben werden.Data specified by a particular filter. stringstring
FilterData3 Daten, die durch einen bestimmten Filter angegeben werden.Data specified by a particular filter. stringstring
FilterData4 Daten, die durch einen bestimmten Filter angegeben werden.Data specified by a particular filter. stringstring
FilterData5 Daten, die durch einen bestimmten Filter angegeben werden.Data specified by a particular filter. stringstring
FilterData6 Daten, die durch einen bestimmten Filter angegeben werden.Data specified by a particular filter. stringstring
FilterData7 Daten, die durch einen bestimmten Filter angegeben werden.Data specified by a particular filter. stringstring
FilterData8 Daten, die durch einen bestimmten Filter angegeben werden.Data specified by a particular filter. stringstring
FilterData9 Daten, die durch einen bestimmten Filter angegeben werden.Data specified by a particular filter. stringstring
FilterData10 Daten, die durch einen bestimmten Filter angegeben werden.Data specified by a particular filter. stringstring
FilterField Ein Filterfeldname für einen bestimmten Filter, der auf die Ansicht angewendet wird.A filter field name for a specific filter that is applied to the view. stringstring
FilterField1 Ein Filterfeldname für einen bestimmten Filter, der auf die Ansicht angewendet wird.A filter field name for a specific filter that is applied to the view. stringstring ID
FilterField2 Ein Filterfeldname für einen bestimmten Filter, der auf die Ansicht angewendet wird.A filter field name for a specific filter that is applied to the view. stringstring ID
FilterField3 Ein Filterfeldname für einen bestimmten Filter, der auf die Ansicht angewendet wird.A filter field name for a specific filter that is applied to the view. stringstring ID
FilterField4 Ein Filterfeldname für einen bestimmten Filter, der auf die Ansicht angewendet wird.A filter field name for a specific filter that is applied to the view. stringstring ID
FilterField5 Ein Filterfeldname für einen bestimmten Filter, der auf die Ansicht angewendet wird.A filter field name for a specific filter that is applied to the view. stringstring ID
FilterField6 Ein Filterfeldname für einen bestimmten Filter, der auf die Ansicht angewendet wird.A filter field name for a specific filter that is applied to the view. stringstring ID
FilterField7 Ein Filterfeldname für einen bestimmten Filter, der auf die Ansicht angewendet wird.A filter field name for a specific filter that is applied to the view. stringstring ID
FilterField8 Ein Filterfeldname für einen bestimmten Filter, der auf die Ansicht angewendet wird.A filter field name for a specific filter that is applied to the view. stringstring ID
FilterField9 Ein Filterfeldname für einen bestimmten Filter, der auf die Ansicht angewendet wird.A filter field name for a specific filter that is applied to the view. stringstring ID
FilterField10 Ein Filterfeldname für einen bestimmten Filter, der auf die Ansicht angewendet wird.A filter field name for a specific filter that is applied to the view. stringstring ID
FilterFields Gibt mehrere Felder an, nach denen für einen Multiplikatorfilter gefiltert wird.Specifies multiple fields that are being filtered on for a multiplier filter. stringstring
FilterFields1 Gibt mehrere Felder an, nach denen für einen Multiplikatorfilter gefiltert wird.Specifies multiple fields that are being filtered on for a multiplier filter. stringstring
FilterFields2 Gibt mehrere Felder an, nach denen für einen Multiplikatorfilter gefiltert wird.Specifies multiple fields that are being filtered on for a multiplier filter. stringstring
FilterFields3 Gibt mehrere Felder an, nach denen für einen Multiplikatorfilter gefiltert wird.Specifies multiple fields that are being filtered on for a multiplier filter. stringstring
FilterFields4 Gibt mehrere Felder an, nach denen für einen Multiplikatorfilter gefiltert wird.Specifies multiple fields that are being filtered on for a multiplier filter. stringstring
FilterFields5 Gibt mehrere Felder an, nach denen für einen Multiplikatorfilter gefiltert wird.Specifies multiple fields that are being filtered on for a multiplier filter. stringstring
FilterFields6 Gibt mehrere Felder an, nach denen für einen Multiplikatorfilter gefiltert wird.Specifies multiple fields that are being filtered on for a multiplier filter. stringstring
FilterFields7 Gibt mehrere Felder an, nach denen für einen Multiplikatorfilter gefiltert wird.Specifies multiple fields that are being filtered on for a multiplier filter. stringstring
FilterFields8 Gibt mehrere Felder an, nach denen für einen Multiplikatorfilter gefiltert wird.Specifies multiple fields that are being filtered on for a multiplier filter. stringstring
FilterFields9 Gibt mehrere Felder an, nach denen für einen Multiplikatorfilter gefiltert wird.Specifies multiple fields that are being filtered on for a multiplier filter. stringstring
FilterFields10 Gibt mehrere Felder an, nach denen für einen Multiplikatorfilter gefiltert wird.Specifies multiple fields that are being filtered on for a multiplier filter. stringstring
FilterValue Der einem bestimmten Filter zugeordnete Filterwert.The filter value associated with a particular filter. Beispielsweise ist FilterField3 FilterValue3 zugeordnet usw.For example, FilterField3 goes with FilterValue3 and so forth. stringstring
FilterValue1 Der einem bestimmten Filter zugeordnete Filterwert.The filter value associated with a particular filter. Beispielsweise ist FilterField3 FilterValue3 zugeordnet usw.For example, FilterField3 goes with FilterValue3 and so forth. stringstring 1
FilterValue2 Der einem bestimmten Filter zugeordnete Filterwert.The filter value associated with a particular filter. Beispielsweise ist FilterField3 FilterValue3 zugeordnet usw.For example, FilterField3 goes with FilterValue3 and so forth. stringstring 1
FilterValue3 Der einem bestimmten Filter zugeordnete Filterwert.The filter value associated with a particular filter. Beispielsweise ist FilterField3 FilterValue3 zugeordnet usw.For example, FilterField3 goes with FilterValue3 and so forth. stringstring 1
FilterValue4 Der einem bestimmten Filter zugeordnete Filterwert.The filter value associated with a particular filter. Beispielsweise ist FilterField3 FilterValue3 zugeordnet usw.For example, FilterField3 goes with FilterValue3 and so forth. stringstring 1
FilterValue5 Der einem bestimmten Filter zugeordnete Filterwert.The filter value associated with a particular filter. Beispielsweise ist FilterField3 FilterValue3 zugeordnet usw.For example, FilterField3 goes with FilterValue3 and so forth. stringstring 1
FilterValue6 Der einem bestimmten Filter zugeordnete Filterwert.The filter value associated with a particular filter. Beispielsweise ist FilterField3 FilterValue3 zugeordnet usw.For example, FilterField3 goes with FilterValue3 and so forth. stringstring 1
FilterValue7 Der einem bestimmten Filter zugeordnete Filterwert.The filter value associated with a particular filter. Beispielsweise ist FilterField3 FilterValue3 zugeordnet usw.For example, FilterField3 goes with FilterValue3 and so forth. stringstring 1
FilterValue8 Der einem bestimmten Filter zugeordnete Filterwert.The filter value associated with a particular filter. Beispielsweise ist FilterField3 FilterValue3 zugeordnet usw.For example, FilterField3 goes with FilterValue3 and so forth. stringstring 1
FilterValue9 Der einem bestimmten Filter zugeordnete Filterwert.The filter value associated with a particular filter. Beispielsweise ist FilterField3 FilterValue3 zugeordnet usw.For example, FilterField3 goes with FilterValue3 and so forth. stringstring 1
FilterValue10 Der einem bestimmten Filter zugeordnete Filterwert.The filter value associated with a particular filter. Beispielsweise ist FilterField3 FilterValue3 zugeordnet usw.For example, FilterField3 goes with FilterValue3 and so forth. stringstring 1
FilterValues Wird mit FilterFields für Multiplikatorfilter verwendet.Used with FilterFields for multiplier filter. Beispielsweise würde FilterFields3 FilterValues3 zugeordnet usw.For example, FilterFields3 would go with FilterValues3 and so forth. stringstring
FilterValues1 Wird mit FilterFields für Multiplikatorfilter verwendet.Used with FilterFields for multiplier filter. Beispielsweise würde FilterFields3 FilterValues3 zugeordnet usw.For example, FilterFields3 would go with FilterValues3 and so forth. stringstring
FilterValues2 Wird mit FilterFields für Multiplikatorfilter verwendet.Used with FilterFields for multiplier filter. Beispielsweise würde FilterFields3 FilterValues3 zugeordnet usw.For example, FilterFields3 would go with FilterValues3 and so forth. stringstring
FilterValues3 Wird mit FilterFields für Multiplikatorfilter verwendet.Used with FilterFields for multiplier filter. Beispielsweise würde FilterFields3 FilterValues3 zugeordnet usw.For example, FilterFields3 would go with FilterValues3 and so forth. stringstring
FilterValues4 Wird mit FilterFields für Multiplikatorfilter verwendet.Used with FilterFields for multiplier filter. Beispielsweise würde FilterFields3 FilterValues3 zugeordnet usw.For example, FilterFields3 would go with FilterValues3 and so forth. stringstring
FilterValues5 Wird mit FilterFields für Multiplikatorfilter verwendet.Used with FilterFields for multiplier filter. Beispielsweise würde FilterFields3 FilterValues3 zugeordnet usw.For example, FilterFields3 would go with FilterValues3 and so forth. stringstring
FilterValues6 Wird mit FilterFields für Multiplikatorfilter verwendet.Used with FilterFields for multiplier filter. Beispielsweise würde FilterFields3 FilterValues3 zugeordnet usw.For example, FilterFields3 would go with FilterValues3 and so forth. stringstring
FilterValues7 Wird mit FilterFields für Multiplikatorfilter verwendet.Used with FilterFields for multiplier filter. Beispielsweise würde FilterFields3 FilterValues3 zugeordnet usw.For example, FilterFields3 would go with FilterValues3 and so forth. stringstring
FilterValues8 Wird mit FilterFields für Multiplikatorfilter verwendet.Used with FilterFields for multiplier filter. Beispielsweise würde FilterFields3 FilterValues3 zugeordnet usw.For example, FilterFields3 would go with FilterValues3 and so forth. stringstring
FilterValues9 Wird mit FilterFields für Multiplikatorfilter verwendet.Used with FilterFields for multiplier filter. Beispielsweise würde FilterFields3 FilterValues3 zugeordnet usw.For example, FilterFields3 would go with FilterValues3 and so forth. stringstring
FilterValues10 Wird mit FilterFields für Multiplikatorfilter verwendet.Used with FilterFields for multiplier filter. Beispielsweise würde FilterFields3 FilterValues3 zugeordnet usw.For example, FilterFields3 would go with FilterValues3 and so forth. stringstring
FilterLookupId Wird beim Filtern nach einem Nachschlagefeld verwendet.Used when filtering on a lookup field. Dies ist die Element-ID der Fremdschlüsselliste, die einen Wert enthält, nach dem gefiltert wird.This is the item id in the foreign list that has a value that is being filtered on. stringstring
FilterLookupId1 Wird beim Filtern nach einem Nachschlagefeld verwendet.Used when filtering on a lookup field. Dies ist die Element-ID der Fremdschlüsselliste, die einen Wert enthält, nach dem gefiltert wird.This is the item id in the foreign list that has a value that is being filtered on. stringstring
FilterLookupId2 Wird beim Filtern nach einem Nachschlagefeld verwendet.Used when filtering on a lookup field. Dies ist die Element-ID der Fremdschlüsselliste, die einen Wert enthält, nach dem gefiltert wird.This is the item id in the foreign list that has a value that is being filtered on. stringstring
FilterLookupId3 Wird beim Filtern nach einem Nachschlagefeld verwendet.Used when filtering on a lookup field. Dies ist die Element-ID der Fremdschlüsselliste, die einen Wert enthält, nach dem gefiltert wird.This is the item id in the foreign list that has a value that is being filtered on. stringstring
FilterLookupId4 Wird beim Filtern nach einem Nachschlagefeld verwendet.Used when filtering on a lookup field. Dies ist die Element-ID der Fremdschlüsselliste, die einen Wert enthält, nach dem gefiltert wird.This is the item id in the foreign list that has a value that is being filtered on. stringstring
FilterLookupId5 Wird beim Filtern nach einem Nachschlagefeld verwendet.Used when filtering on a lookup field. Dies ist die Element-ID der Fremdschlüsselliste, die einen Wert enthält, nach dem gefiltert wird.This is the item id in the foreign list that has a value that is being filtered on. stringstring
FilterLookupId6 Wird beim Filtern nach einem Nachschlagefeld verwendet.Used when filtering on a lookup field. Dies ist die Element-ID der Fremdschlüsselliste, die einen Wert enthält, nach dem gefiltert wird.This is the item id in the foreign list that has a value that is being filtered on. stringstring
FilterLookupId7 Wird beim Filtern nach einem Nachschlagefeld verwendet.Used when filtering on a lookup field. Dies ist die Element-ID der Fremdschlüsselliste, die einen Wert enthält, nach dem gefiltert wird.This is the item id in the foreign list that has a value that is being filtered on. stringstring
FilterLookupId8 Wird beim Filtern nach einem Nachschlagefeld verwendet.Used when filtering on a lookup field. Dies ist die Element-ID der Fremdschlüsselliste, die einen Wert enthält, nach dem gefiltert wird.This is the item id in the foreign list that has a value that is being filtered on. stringstring
FilterLookupId9 Wird beim Filtern nach einem Nachschlagefeld verwendet.Used when filtering on a lookup field. Dies ist die Element-ID der Fremdschlüsselliste, die einen Wert enthält, nach dem gefiltert wird.This is the item id in the foreign list that has a value that is being filtered on. stringstring
FilterLookupId10 Wird beim Filtern nach einem Nachschlagefeld verwendet.Used when filtering on a lookup field. Dies ist die Element-ID der Fremdschlüsselliste, die einen Wert enthält, nach dem gefiltert wird.This is the item id in the foreign list that has a value that is being filtered on. stringstring
FilterOnly stringstring
FilterOp Filteroperator.Filter operator. Wird verwendet, wenn mit anderen Operatoren als Eq gefiltert wird (Geq, Leq usw.).Used when filtering with other operators than Eq (Geq, Leq etc.) stringstring Geq
FilterOp1 Filteroperator.Filter operator. Wird verwendet, wenn mit anderen Operatoren als Eq gefiltert wird (Geq, Leq usw.).Used when filtering with other operators than Eq (Geq, Leq etc.) stringstring Geq
FilterOp2 Filteroperator.Filter operator. Wird verwendet, wenn mit anderen Operatoren als Eq gefiltert wird (Geq, Leq usw.).Used when filtering with other operators than Eq (Geq, Leq etc.) stringstring Geq
FilterOp3 Filteroperator.Filter operator. Wird verwendet, wenn mit anderen Operatoren als Eq gefiltert wird (Geq, Leq usw.).Used when filtering with other operators than Eq (Geq, Leq etc.) stringstring Geq
FilterOp4 Filteroperator.Filter operator. Wird verwendet, wenn mit anderen Operatoren als Eq gefiltert wird (Geq, Leq usw.).Used when filtering with other operators than Eq (Geq, Leq etc.) stringstring Geq
FilterOp5 Filteroperator.Filter operator. Wird verwendet, wenn mit anderen Operatoren als Eq gefiltert wird (Geq, Leq usw.).Used when filtering with other operators than Eq (Geq, Leq etc.) stringstring Geq
FilterOp6 Filteroperator.Filter operator. Wird verwendet, wenn mit anderen Operatoren als Eq gefiltert wird (Geq, Leq usw.).Used when filtering with other operators than Eq (Geq, Leq etc.) stringstring Geq
FilterOp7 Filteroperator.Filter operator. Wird verwendet, wenn mit anderen Operatoren als Eq gefiltert wird (Geq, Leq usw.).Used when filtering with other operators than Eq (Geq, Leq etc.) stringstring Geq
FilterOp8 Filteroperator.Filter operator. Wird verwendet, wenn mit anderen Operatoren als Eq gefiltert wird (Geq, Leq usw.).Used when filtering with other operators than Eq (Geq, Leq etc.) stringstring Geq
FilterOp9 Filteroperator.Filter operator. Wird verwendet, wenn mit anderen Operatoren als Eq gefiltert wird (Geq, Leq usw.).Used when filtering with other operators than Eq (Geq, Leq etc.) stringstring Geq
FilterOp10 Filteroperator.Filter operator. Wird verwendet, wenn mit anderen Operatoren als Eq gefiltert wird (Geq, Leq usw.).Used when filtering with other operators than Eq (Geq, Leq etc.) stringstring Geq
ID Die Element-ID des Elements, dessen Informationen gesucht werden.The item id of the item whose information is being sought. numbernumber
InplaceSearchQuery Suchbegriff für eine vollständige Listensuche.Search term for a full list search. stringstring
InplaceFullListSearch Ein boolescher Wert, der angibt, ob es eine vollständige Listensuche vorliegt.A boolean that specifies whether there is a full list search. stringstring
IsCSR Gibt an, ob diese Ansicht eine clientseitige gerenderte Ansicht ist.Whether this view is a client side rendered view. stringstring
CustomAction stringstring
IsGroupRender Wird verwendet, um die IsGroupRender-Eigenschaft der SPView festzulegen.Used to set the IsGroupRender property of the SPView. stringstring
IsRibbon stringstring
IsXslView Gibt an, ob diese Ansicht eine XSLT-Listenansicht ist.Whether this view is an xslt list view. stringstring
List stringstring
ListId stringstring
ListViewPageUrl stringstring
OverrideScope Wird verwendet, um einen Bereich in der gerenderten Ansicht zu überschreiben: SPView.ScopeUsed to override a scope on the rendered view: SPView.Scope stringstring
OverrideSelectCommand Wird verwendet, um sicherzustellen, dass bestimmte Felder in der Abfrage vorhanden sind, unabhängig davon, ob sie explizit in die Ansicht einschlossen werden.Used to make sure that certain fields are present in the query regardless of whether they are explicitly included in the view. stringstring
PageFirstRow Auslagerungsinformationen über die erste Zeile, die angefordert wird.Paging information about the first row that is requested. Wird für Auslagerungslistenansichten verwendet.Used for paging list views. stringstring
PageLastRow Auslagerungsinformationen über die letzte Zeile, die angefordert wird.Paging information about the last row that is requested. Wird für Auslagerungslistenansichten verwendet.Used for paging list views. stringstring
RootFolder Der Ordner, den die Ansicht anzeigt.The folder that the view is displaying. stringstring
SortField Ein Feld, nach dem die Ansicht sortiert werden soll.A field that the view should be sorted on. stringstring ID
SortField1 Ein Feld, nach dem die Ansicht sortiert werden soll.A field that the view should be sorted on. stringstring ID
SortField2 Ein Feld, nach dem die Ansicht sortiert werden soll.A field that the view should be sorted on. stringstring ID
SortField3 Ein Feld, nach dem die Ansicht sortiert werden soll.A field that the view should be sorted on. stringstring ID
SortField4 Ein Feld, nach dem die Ansicht sortiert werden soll.A field that the view should be sorted on. stringstring ID
SortField5 Ein Feld, nach dem die Ansicht sortiert werden soll.A field that the view should be sorted on. stringstring ID
SortField6 Ein Feld, nach dem die Ansicht sortiert werden soll.A field that the view should be sorted on. stringstring ID
SortField7 Ein Feld, nach dem die Ansicht sortiert werden soll.A field that the view should be sorted on. stringstring ID
SortField8 Ein Feld, nach dem die Ansicht sortiert werden soll.A field that the view should be sorted on. stringstring ID
SortField9 Ein Feld, nach dem die Ansicht sortiert werden soll.A field that the view should be sorted on. stringstring ID
SortField10 Ein Feld, nach dem die Ansicht sortiert werden soll.A field that the view should be sorted on. stringstring ID
SortFields Gibt den Namen des ersten Felds an, nach dem sortiert werden soll.Specifies the name of the first field to sort by stringstring
SortFieldValues Gibt den Namen des ersten Felds an, nach dem sortiert werden soll.Specifies the name of the first field to sort by stringstring
SortDir Die Sortierrichtung einer Ad-hoc-Sortierung, die auf die Ansicht angewendet wird.The sort direction of an ad hoc sort that is being applied to the view. stringstring Desc
SortDir1 Die Sortierrichtung einer Ad-hoc-Sortierung, die auf die Ansicht angewendet wird.The sort direction of an ad hoc sort that is being applied to the view. stringstring Desc
SortDir2 Die Sortierrichtung einer Ad-hoc-Sortierung, die auf die Ansicht angewendet wird.The sort direction of an ad hoc sort that is being applied to the view. stringstring Desc
SortDir3 Die Sortierrichtung einer Ad-hoc-Sortierung, die auf die Ansicht angewendet wird.The sort direction of an ad hoc sort that is being applied to the view. stringstring Desc
SortDir4 Die Sortierrichtung einer Ad-hoc-Sortierung, die auf die Ansicht angewendet wird.The sort direction of an ad hoc sort that is being applied to the view. stringstring Desc
SortDir5 Die Sortierrichtung einer Ad-hoc-Sortierung, die auf die Ansicht angewendet wird.The sort direction of an ad hoc sort that is being applied to the view. stringstring Desc
SortDir6 Die Sortierrichtung einer Ad-hoc-Sortierung, die auf die Ansicht angewendet wird.The sort direction of an ad hoc sort that is being applied to the view. stringstring Desc
SortDir7 Die Sortierrichtung einer Ad-hoc-Sortierung, die auf die Ansicht angewendet wird.The sort direction of an ad hoc sort that is being applied to the view. stringstring Desc
SortDir8 Die Sortierrichtung einer Ad-hoc-Sortierung, die auf die Ansicht angewendet wird.The sort direction of an ad hoc sort that is being applied to the view. stringstring Desc
SortDir9 Die Sortierrichtung einer Ad-hoc-Sortierung, die auf die Ansicht angewendet wird.The sort direction of an ad hoc sort that is being applied to the view. stringstring Desc
SortDir10 Die Sortierrichtung einer Ad-hoc-Sortierung, die auf die Ansicht angewendet wird.The sort direction of an ad hoc sort that is being applied to the view. stringstring Desc
View Gibt die Basisansicht an, die zum Rendern der Liste verwendet wird.Specifies the base view that will be used to render the list. GUIDGUID 3d13559e-3071-5000-76b8-8f1ca6b835f0
ViewPath Gibt den Pfad der Ansicht an, die zum Rendern der Liste verwendet wird.Specifies the path of the view that will be used to render the list. Bei Angabe von ViewId wird ViewId verwendet, und dieser Parameter wird ignoriert.If ViewId is given then the ViewId will be used and this parameters will be ignored. stringstring
ViewCount Wenn mehrere Listenansichten auf einer Seite vorhanden sind, wird hiermit eine davon identifiziert.When multiple list views are on a page, this identifies one of them. stringstring
ViewId Gibt die Basisansicht an, die zum Rendern der Liste verwendet wird.Specifies the base view that will be used to render the list. Ad-hoc-Parameter werden auf diese Ansicht angewendet.ad-hoc parameters will be applied on top of this view. Bei Angabe von ViewXml und BaseViewId wird ViewXml verwendet, und die Ad-hoc-Parameter werden ignoriert.If both ViewXml and BaseViewId are given then the ViewXml will be used and the ad-hoc parameters will be ignored. stringstring
WebPartId Die ID des Listenansicht-Webparts, das diese Ansicht anzeigt.The id of the list view web part that is showing this view. stringstring

AnforderungsheaderRequest headers

KopfzeileHeader WertValue
AnnehmenAccept application/json;odata=nometadataapplication/json;odata=nometadata
InhaltstypContent-Type application/json;odata=nometadataapplication/json;odata=nometadata

AnforderungstextRequest body

{
    "parameters": {
        "AddRequiredFields": "true",
        "DatesInUtc": "true",
        "RenderOptions": 17
    }
}
EigenschaftProperty BeschreibungDescription TypType BeispielExample
AddRequiredFields Gibt an, ob erforderliche Felder zurückgegeben werden sollenSpecifies if required fields should be returned or not boolbool true
AllowMultipleValueFilterForTaxonomyFields Gibt an, ob das Filtern mit mehreren Werten für Taxonomiefelder zulässig istSpecifies if multi value filtering is allowed for taxonomy fields or not boolbool true
DatesInUtc Gibt an, ob das DateTime-Feld in UTC oder Ortszeit zurückgegeben wirdSpecifies if we return DateTime field in UTC or local time. boolbool true
ExpandGroups Gibt an, ob die Gruppierung erweitert werden sollSpecifies if the grouping should be expanded or not. boolbool true
FirstGroupOnly Gibt an, wenn nur die erste Gruppe zurückgegeben werden soll (unabhängig vom Ansichtsschema)Specifies if only the first group should be returned or not (regardless of view schema). boolbool true
FolderServerRelativeUrl Gibt die URL des Ordners an, aus dem Elemente zurückgegeben werden sollenSpecifies the url to the folder from which to return items. stringstring /sites/team-a/lists/Orders/Europe
ImageFieldsToTryRewriteToCdnUrls Durch Trennzeichen getrennte Liste von Feldnamen, deren Werte in CDN-URLs umgeschrieben werden sollenComma-separated list of field names whose values should be rewritten to CDN URLs stringstring ArticleImage,SecondaryImage
OverrideViewXml Gibt den Überschreib-XML-Code an, der mit der Ansichts-CAML kombiniert werden soll.Specifies the override XML to be combined with the View CAML. Gilt nur für den Query/Where-Teil der Ansichts-CAML.Applies only to the Query/Where part of the View CAML. stringstring <Query><Where><Gt><FieldRef Name=\"OrderCount\" /><Value Type=\"Number\">3</Value></Gt></Where></Query>
Paging Gibt die Auslagerungsinformationen anSpecifies the paging information. stringstring
RenderOptions Gibt den zurückzugebenden Ausgabetyp anSpecifies the type of output to return. SPRenderListDataOptionsSPRenderListDataOptions Mögliche Werte finden Sie im nächsten Abschnitt.See the next section for possible values. Sie können mehrere Werte angeben, indem Sie die Werte zusammen hinzufügen.You can specify multiple values by adding their values together
ReplaceGroup Gibt an, ob die Gruppierung ersetzt werden soll, um die GroupBy-Einschränkkung zu behandeln.Specifies if the grouping should be replaced or not to deal with GroupBy throttling. boolbool true
ViewXml Gibt den CAML-Ansichts-XML-Code an.Specifies the CAML view XML. stringstring
SPRenderListDataOptionsSPRenderListDataOptions
BeschriftungLabel BeschreibungDescription WertValue
None Gibt die Standardausgabe zurückReturn default output 0
ContextInfo Gibt Listenkontextinformationen zurückReturn list context information 1
ListData Gibt Listendaten zurück (entspricht None)Return list data (same as None) 2
ListSchema Gibt das Listenschema zurückReturn list schema 4
MenuView Gibt den HTML-Code für das Listenmenü zurückReturn HTML for the list menu 8
ListContentType Gibt Informationen zu Listeninhaltstypen zurück.Returns information about list content types. Muss mit dem ContextInfo-Flag kombiniert werden.Must be combined with the ContextInfo flag 16
FileSystemItemId Die zurückgegebene Liste enthält nach Möglichkeit ein FileSystemItemId Feld für jedes Element.The returned list will have a FileSystemItemId field on each item if possible. Muss mit dem ListData-Flag kombiniert werden.Must be combined with the ListData flag 32
ClientFormSchema Gibt das Clientformularschema zum Hinzufügen und Bearbeiten von Elementen zurück.Returns the client form schema to add and edit items. 64
QuickLaunch Gibt QuickLaunch-Navigationsknoten zurückReturns QuickLaunch navigation nodes. 128
Spotlight Gibt Spotlight-Renderinformationen zurückReturns Spotlight rendering information. 256
Visualization Gibt Visualiserungs-Renderinformationen zurückReturns Visualization rendering information. 512
ViewMetadata Gibt den Ansichts-XML-Code und andere Informationen über die aktuelle Ansicht zurückReturns view XML and other information about the current view. 1024
DisableAutoHyperlink Verhindert, dass AutoHyperlink für Textfelder in diese Abfrage ausgeführt wirdPrevents AutoHyperlink from being run on text fields in this query. 2048
EnableMediaTAUrls Aktiviert URLs, die auf den Media TA-Dienst zeigen, z. B. .thumbnailUrl, .videoManifestUrl, .pdfConversionUrls.Enables URLs pointing to Media TA service, such as .thumbnailUrl, .videoManifestUrl, .pdfConversionUrls. 4096
ParentInfo Gibt Informationen zum übergeordneten Ordner zurückReturns parent folder information. 8192
PageContextInfo Gibt Seitenkontextinformationen für die aktuelle Liste zurück, die gerendert wirdReturns page context info for the current list being rendered. 16384
ClientSideComponentManifest Gibt Manifestinformationen der clientseitigen Komponente im Zusammenhang mit der Liste zurückReturn client-side component manifest information associated with the list. Reserviert für zukünftige VerwendungReserved for future use 32768

BeispieleExamples

Element mit einer bestimmten ID abrufenRetrieve item with specific ID

POST https://contoso.sharepoint.com/sites/team-a/_api/web/GetList(@listUrl)/RenderListDataAsStream?@listUrl=%27%2Fsites%2Fteam-a%2Flists%2FList%27&FilterField1=ID&FilterValue1=1
accept: application/json;odata=nometadata

Elemente absteigend nach ID sortierenSort items descending by ID

POST https://contoso.sharepoint.com/sites/team-a/_api/web/GetList(@listUrl)/RenderListDataAsStream?@listUrl=%27%2Fsites%2Fteam-a%2Flists%2FList%27&SortField=ID&SortDir=Desc
accept: application/json;odata=nometadata

Elemente aus dem angegebenen Ordner abrufenRetrieve items from the specified folder

POST https://contoso.sharepoint.com/sites/team-a/_api/web/GetList(@listUrl)/RenderListDataAsStream?@listUrl=%27%2Fsites%2Fteam-a%2Flists%2FOrders%27
accept: application/json;odata=nometadata
content-type: application/json;odata=nometadata

{
    "parameters": {
        "FolderServerRelativeUrl": "/sites/team-a/lists/Orders/Europe"
    }
}

Listenschema abrufenRetrieve list schema

POST https://contoso.sharepoint.com/sites/team-a/_api/web/GetList(@listUrl)/RenderListDataAsStream?@listUrl=%27%2Fsites%2Fteam-a%2Flists%2FList%27
accept: application/json;odata=nometadata
content-type: application/json;odata=nometadata

{
    "parameters": {
        "RenderOptions": 4
    }
}

Informationen zu Listeninhaltstypen abrufenRetrieve information about list content types

POST https://contoso.sharepoint.com/sites/team-a/_api/web/GetList(@listUrl)/RenderListDataAsStream?@listUrl=%27%2Fsites%2Fteam-a%2Flists%2FList%27
accept: application/json;odata=nometadata
content-type: application/json;odata=nometadata

{
    "parameters": {
        "RenderOptions": 17
    }
}

Listenelement erstellenCreate list item

Das folgende Beispiel zeigt, wie Sie ein Listenelement erstellen.The following example shows how to create a list item.

Hinweis

Um diese Operation durchzuführen, müssen Sie die Eigenschaft ListItemEntityTypeFullName der Liste kennen und sie als Wert von type im Textkörper der HTTP-Anforderung übergeben.To do this operation, you must know the ListItemEntityTypeFullName property of the list and pass that as the value of type in the HTTP request body.

url: http://site url/_api/web/lists/GetByTitle('Test')/items
method: POST
body: { '__metadata': { 'type': 'SP.Data.TestListItem' }, 'Title': 'Test'}
headers:
    Authorization: "Bearer " + accessToken
     X-RequestDigest: form digest value
    accept: "application/json;odata=verbose"
    content-type: "application/json;odata=verbose"
    content-length:length of post body

Listenelement in einem Ordner erstellenCreate list item in a folder

Das folgende Beispiel zeigt, wie Sie ein Listenelement in einem Ordner erstellen.The following example shows how to create a list item.

POST /_api/web/lists/GetByTitle('Test')/AddValidateUpdateItemUsingPath

URI-ParameterURI Parameters

KeineNone

AnforderungsheaderRequest headers

KopfzeileHeader WertValue
AnnehmenAccept application/json;odata=nometadataapplication/json;odata=nometadata
InhaltstypContent-Type application/json;odata=nometadataapplication/json;odata=nometadata
x-requestdigestx-requestdigest Die entsprechende Digest für die aktuelle WebsiteThe appropriate digest for current site

AnforderungstextRequest body

{
    "listItemCreateInfo": {
        "FolderPath":  { "DecodedUrl": "https://contoso.sharepoint.com/lists/Test/Folder/SubFolder" },
        "UnderlyingObjectType": 0
    },
    "formValues": [
        {
            "FieldName": "Title",
            "FieldValue": "Item"
        }
    ],
    "bNewDocumentUpdate": false
}
EigenschaftProperty BeschreibungDescription
listItemCreateInfolistItemCreateInfo Informationen zur der Liste und dem Ordner, in denen das Element erstellt werden sollInformation about the list and folder where the item should be created
listItemCreateInfo.FolderPath.DecodedUrllistItemCreateInfo.FolderPath.DecodedUrl Absolute URL des Ordners, in dem das Element erstellt werden sollAbsolute URL of the folder where the item should be created
listItemCreateInfo.UnderlyingObjectTypelistItemCreateInfo.UnderlyingObjectType Der Typ des zu erstellenden Elements.Type of item to create. Weitere Informationen finden Sie unter https://msdn.microsoft.com/en-us/library/microsoft.sharepoint.client.filesystemobjecttype(v=office.14).aspx. https://msdn.microsoft.com/en-us/library/microsoft.sharepoint.client.filesystemobjecttype(v=office.14).aspxFor more information see https://msdn.microsoft.com/en-us/library/microsoft.sharepoint.client.filesystemobjecttype(v=office.14).aspx
formValuesformValues Array von Feldnamen und Werten zum Festlegen des neu erstellten ElementsArray of field names and values to set on the newly created item
bNewDocumentUpdatebNewDocumentUpdate Auf false festlegen, um ein Listenelement zu erstellenSet to false to create a list item

AntwortenResponses

NameName TypType BeschreibungDescription
200 OK200 OK BooleschBoolean ErfolgSuccess
{
  "value": [
    {
      "ErrorMessage": null,
      "FieldName": "Title",
      "FieldValue": "Item",
      "HasException": false,
      "ItemId": 0
    },
    {
      "ErrorMessage": null,
      "FieldName": "Id",
      "FieldValue": "1",
      "HasException": false,
      "ItemId": 0
    }
  ]
}

Die value-Eigenschaft enthält die Liste der Eigenschaften, die beim Erstellen des Listenelements festgelegt wurden.The value property contains the list of properties that have been set when creating the list item.

Listenelement aktualisierenUpdate list item

Das folgende Beispiel zeigt, wie Sie ein Listenelement aktualisieren.The following example shows how to update a list item.

Hinweis

Um diese Operation durchzuführen, müssen Sie die Eigenschaft ListItemEntityTypeFullName der Liste kennen und sie als Wert von type im Textkörper der HTTP-Anforderung übergeben.To do this operation, you must know the ListItemEntityTypeFullName property of the list and pass that as the value of type in the HTTP request body.

url: http://site url/_api/web/lists/GetByTitle('Test')/items(item id)
method: POST
body: { '__metadata': { 'type': 'SP.Data.TestListItem' }, 'Title': 'TestUpdated'}
headers:
    Authorization: "Bearer " + accessToken
     X-RequestDigest: form digest value
    "IF-MATCH": etag or "*"
    "X-HTTP-Method":"MERGE",
    accept: "application/json;odata=verbose"
    content-type: "application/json;odata=verbose"
    content-length:length of post body

Listenelement löschenDelete list item

Das folgende Beispiel zeigt, wie Sie ein Listenelement löschen.The following example shows how to delete a list item.

url: http://site url/_api/web/lists/GetByTitle('Test')/items(item id)
method: POST
headers:
    Authorization: "Bearer " + accessToken
     X-RequestDigest: form digest value
    "IF-MATCH": etag or "*"
    "X-HTTP-Method":"DELETE"


Verwenden von ETag-Werten zum Bestimmen der Version von Dokument- und ListenelementenUsing ETag values to determine document and list item versioning

Der SharePoint REST-Dienst, der sich nach dem OData-Standard richtet, verwendet HTML ETags für die Gleichzeitigkeitssteuerung von SharePoint-Listen und -Listenelementen.The SharePoint REST service, which follows the OData standard, uses HTML ETags for concurrency control of SharePoint lists and list items. Um die Version eines Elements beim Ausführen einer PUT-, MERGE- oder DELETE-Anforderung zu prüfen, geben Sie ein ETag im HTTP-Anforderungsheader If-Match an.To check on an item's version when you perform a PUT, MERGE, or DELETE request, specify an ETag in the If-Match HTTP request header.

Wenn das in Ihrer Anforderung angegebene ETag nicht mit dem ETag des Dokument- oder Listenelements auf dem Server übereinstimmt, gibt der REST-Dienst gemäß der OData-Spezifikation eine 412-Ausnahme zurück.If the ETag you specify in your request does not match the ETag of the document or list item on the server, the REST service returns a 412 exception, per the OData specification.

  • Wenn Sie ein Überschreiben des Elements unabhängig von der Version erzwingen möchten, legen Sie den ETag-Wert auf "*" fest.To force an overwrite of the item regardless of version, set the ETag value to "*".

  • Wenn Sie kein ETag angeben, überschreibt SharePoint das Element unabhängig von der Version.If you do not specify an ETag, SharePoint overwrites the item regardless of version.

In SharePoint gelten ETags nur für SharePoint-Listen und Listenelemente.Within SharePoint, ETags apply only to SharePoint lists and list items.

Siehe auchSee also