ListItem-Klasse
Steht für ein Element oder eine Zeile in einer Liste.
Vererbungshierarchie
System.Object
Microsoft.SharePoint.Client.ClientObject
Microsoft.SharePoint.Client.SecurableObject
Microsoft.SharePoint.Client.ListItem
Namespace: Microsoft.SharePoint.Client
Assemblys: Microsoft.SharePoint.Client.Silverlight (in Microsoft.SharePoint.Client.Silverlight.dll); Microsoft.SharePoint.Client.Phone (in Microsoft.SharePoint.Client.Phone.dll) Microsoft.SharePoint.Client (in Microsoft.SharePoint.Client.dll)
Syntax
'Declaration
Public Class ListItem _
Inherits SecurableObject
'Usage
Dim instance As ListItem
public class ListItem : SecurableObject
Hinweise
Enthält CSOM Erweiterungssymbol Felder, die die Felder in der Liste übergeordneten definiert entsprechen. Der Name des Felds CSOM Erweiterungssymbol ist der Name des Felds in der Liste definiert und CSOM Erweiterungssymbol Feldwert ist der Wert des Felds im Listenelement. In der folgenden Tabelle wird die Zuordnung zwischen Feldtypen und Werte definiert.
Feldtyp |
CSOM-Expando-Feldwerttyp |
Bedeutung |
---|---|---|
Integer |
Wenn deren Wert nicht definiert ist, muss CSOM ein Nullverweis (Nothing in Visual Basic)sein, andernfalls muss es CSOM Int32. |
Feld ' ermöglicht eine ganze Zahl. |
Text |
Wenn deren Wert nicht definiert ist, muss CSOM ein Nullverweis (Nothing in Visual Basic)sein, andernfalls muss es CSOM Zeichenfolge. |
Feld ' ermöglicht eine Textzeichenfolge begrenzter Länge. |
Note |
Wenn deren Wert nicht definiert ist, muss CSOM ein Nullverweis (Nothing in Visual Basic)sein, andernfalls muss es CSOM Zeichenfolge. |
Feld ' ermöglicht größere Textmengen. |
DateTime |
Wenn deren Wert nicht definiert ist, muss CSOM ein Nullverweis (Nothing in Visual Basic)sein, andernfalls muss es CSOM DateTime. |
Feld ' ermöglicht vollständige Datums- und Zeitangaben sowie Datum nur Werte. |
Counter |
Muss CSOM Int32 sein. |
Zähler ist ein monoton steigenden Feld für ganze Zahlen, und hat einen eindeutigen in Bezug auf die anderen Werten, die für das Feld in der Liste gespeichert werden. Indikator ist nur für die Liste Bezeichner Elementfeld verwendet und nicht für die Verwendung an einer anderen Stelle vorgesehen. |
Choice |
Wenn deren Wert nicht definiert ist, muss CSOM ein Nullverweis (Nothing in Visual Basic)sein, andernfalls muss es CSOM Zeichenfolge. |
Feld ' ermöglicht Auswahl aus einer Reihe von Vorschlägen Werte. Ein Auswahlfeld unterstützt eine Feld Ebene Einstellung gibt an, ob Freiform-Werte unterstützt werden. |
Lookup |
Wenn deren Wert nicht definiert ist, muss CSOM ein Nullverweis (Nothing in Visual Basic)sein, andernfalls muss es CSOM Objekt. |
Feld können einen Bezug auf ein anderes Listenelement. Das Feld unterstützt Angabe einer Liste-ID für eine Zielliste. Ein Websitebezeichner optional kann auch angegeben werden die gibt an, die Website in der Liste die das Ziel der Suche enthält. |
Boolean |
Wenn deren Wert nicht definiert ist, muss CSOM ein Nullverweis (Nothing in Visual Basic)sein, andernfalls muss es CSOM boolesche sein. |
Feld ' ermöglicht einen true oder false Wert an. |
Number |
Wenn deren Wert nicht definiert ist, muss null CSOM sein, andernfalls muss es CSOM doppelte sein. |
Feld ' ermöglicht eine positive oder negative Zahl an. Ein numerisches Feld unterstützt eine Feld Einstellung verwendet, um die Anzahl der Dezimalstellen angeben angezeigt werden. |
Currency |
Wenn deren Wert nicht definiert ist, muss CSOM ein Nullverweis (Nothing in Visual Basic)sein, andernfalls muss es CSOM doppelte sein. |
Feld für die Daten im Zusammenhang mit Währung können. Das Feld "Währung" verfügt über eine CurrencyLocaleId-Eigenschaft die Gebietsschema-ID für die zu verwendende Währung annimmt. |
URL |
Wenn deren Wert nicht definiert ist, muss CSOM ein Nullverweis (Nothing in Visual Basic)sein, andernfalls muss es CSOM Objekt. |
Feld ' ermöglicht eine URL und eine optionale Beschreibung für die URL. |
Computed |
Nicht zutreffend |
Feld gibt Ausgabe basierend auf dem Wert der anderen Spalten wieder. |
Threading |
Wenn deren Wert nicht definiert ist, muss CSOM ein Nullverweis (Nothing in Visual Basic)sein, andernfalls muss es CSOM Zeichenfolge. |
Enthält Daten zu den Threads von Elementen in einer Diskussionsrunde. |
Guid |
Wenn deren Wert nicht definiert ist, muss CSOM ein Nullverweis (Nothing in Visual Basic)sein, andernfalls muss es CSOM GUID. |
Gibt an, dass der Wert im Feld eine GUID ist. |
MultiChoice |
Wenn deren Wert nicht definiert ist, muss CSOM ein Nullverweis (Nothing in Visual Basic)sein, andernfalls muss es CSOM Matrix. |
Feld können einen oder mehrere Werte in einem Satz von angegebenen Optionen. Ein Auswahlfelder Feld kann auch Freiform-Werte unterstützen. |
GridChoice |
Wenn deren Wert nicht definiert ist, muss CSOM ein Nullverweis (Nothing in Visual Basic)sein, andernfalls muss es CSOM Matrix. |
Raster Wahlmöglichkeiten unterstützt Angabe von mehreren Zahl Skalen in einer Liste an. |
Calculated |
Nicht zutreffend |
Feldwert wird basierend auf den Wert der anderen Spalten berechnet. |
Datei |
Wenn deren Wert nicht definiert ist, muss CSOM ein Nullverweis (Nothing in Visual Basic)sein, andernfalls muss es CSOM Zeichenfolge. |
Gibt einen Verweis auf eine Datei an, die verwendet werden kann, um den Inhalt der betreffenden Datei abzurufen. |
Anhänge |
Wenn deren Wert nicht definiert ist, muss CSOM ein Nullverweis (Nothing in Visual Basic)sein, andernfalls muss es CSOM boolesche sein. |
Feld beschreibt, ob eine oder mehrere Dateien mit dem Element verknüpft sind. Weitere Informationen zu Anlagen finden Sie unter Anlagen. true verfügt, wenn ein Listenelement Anlagen und false , wenn ein Listenelement hat Anlagen nicht. |
User |
Wenn deren Wert nicht definiert ist, muss CSOM ein Nullverweis (Nothing in Visual Basic)sein, andernfalls muss es CSOM Objekt. |
Ein Verweis auf einen bestimmten Benutzer in der Liste Benutzerinformationen. |
Recurrence |
Wenn deren Wert nicht definiert ist, muss CSOM ein Nullverweis (Nothing in Visual Basic)sein, andernfalls muss es CSOM boolesche sein. |
Gibt an, ob ein Feld ein Serienmuster für ein Element enthält. |
CrossProjectLink |
Wenn deren Wert nicht definiert ist, muss CSOM ein Nullverweis (Nothing in Visual Basic)sein, andernfalls muss es CSOM boolesche sein. |
Feld können einen Link zu einer Besprechungsarbeitsbereich-Website. |
ModStat |
Wenn deren Wert nicht definiert ist, muss CSOM ein Nullverweis (Nothing in Visual Basic)sein, andernfalls muss es CSOM int32. |
Gibt den aktuellen Status eines Moderationsprozesses in dem Dokument an. |
Error |
Nicht zutreffend |
Gibt Fehler an. Wert = 24. |
ContentTypeId |
Wenn deren Wert nicht definiert ist, muss CSOM ein Nullverweis (Nothing in Visual Basic)sein, andernfalls muss es CSOM Objekt. |
Feld enthält einen Inhaltstyp Bezeichner für ein Element. ContentTypeId entspricht der Struktur in ContentTypeId definiert. |
PageSeparator |
Nicht zutreffend |
Stellt einen Platzhalter für ein Seitentrennzeichen in einer Umfrageliste dar. PageSeparator ist nur für die Verwendung mit einer Umfrageliste gedacht. |
ThreadIndex |
Wenn deren Wert nicht definiert ist, muss CSOM ein Nullverweis (Nothing in Visual Basic)sein, andernfalls muss es CSOM Zeichenfolge. |
Enthält einen kompilierten Index von Threads in einer Diskussionsrunde. |
WorkflowStatus |
Wenn deren Wert nicht definiert ist, muss CSOM ein Nullverweis (Nothing in Visual Basic)sein, andernfalls muss es CSOM Int32. |
Enthält den Status in einem laufenden Workflow für ein bestimmtes Element. |
AllDayEvent |
Wenn deren Wert nicht definiert ist, muss CSOM ein Nullverweis (Nothing in Visual Basic)sein, andernfalls muss es CSOM boolesche sein. |
Das Feld AllDayEvent wird nur in Verbindung mit einer Ereignisliste verwendet. true ist das Element ein ganztägiges Ereignis (d. h., tritt nicht während einer bestimmten Folge von Stunden in einem Tag). |
WorkflowEventType |
Wenn deren Wert nicht definiert ist, muss CSOM ein Nullverweis (Nothing in Visual Basic)sein, andernfalls muss es CSOM Int32. |
Eine Beschreibung des Typs eines ein zurückliegenden Workflow-Ereignis. Weitere Informationen finden Sie unter WorkflowEventType Enumeration. |
Betriebsanlagen |
Wenn deren Wert nicht definiert ist, muss CSOM ein Nullverweis (Nothing in Visual Basic)sein, andernfalls muss es CSOM Matrix. |
|
FreeBusy |
Wenn deren Wert nicht definiert ist, muss CSOM ein Nullverweis (Nothing in Visual Basic)sein, andernfalls muss es CSOM Zeichenfolge. |
|
Overbook |
Wenn deren Wert nicht definiert ist, muss CSOM ein Nullverweis (Nothing in Visual Basic)sein, andernfalls muss es CSOM Zeichenfolge. |
|
Confidential |
Wenn deren Wert nicht definiert ist, muss CSOM ein Nullverweis (Nothing in Visual Basic)sein, andernfalls muss es CSOM boolesche sein. |
|
WhatsNew |
Wenn deren Wert nicht definiert ist, muss CSOM ein Nullverweis (Nothing in Visual Basic)sein, andernfalls muss es CSOM boolesche sein. |
|
DueDate |
Wenn deren Wert nicht definiert ist, muss CSOM ein Nullverweis (Nothing in Visual Basic)sein, andernfalls muss es CSOM DateTime. |
|
AllowEditing |
Wenn deren Wert nicht definiert ist, muss CSOM ein Nullverweis (Nothing in Visual Basic)sein, andernfalls muss es CSOM boolesche sein. |
|
SendTo |
Wenn deren Wert nicht definiert ist, muss CSOM ein Nullverweis (Nothing in Visual Basic)sein, andernfalls muss es CSOM Matrix |
|
Confirmations |
Wenn deren Wert nicht definiert ist, muss CSOM ein Nullverweis (Nothing in Visual Basic)sein, andernfalls muss es CSOM Zeichenfolge. |
|
CallTo |
Wenn deren Wert nicht definiert ist, muss CSOM ein Nullverweis (Nothing in Visual Basic)sein, andernfalls muss es CSOM Matrix. |
|
CallTime |
Wenn deren Wert nicht definiert ist, muss CSOM ein Nullverweis (Nothing in Visual Basic)sein, andernfalls muss es CSOM DateTime. |
|
Whereabout |
Wenn deren Wert nicht definiert ist, muss CSOM ein Nullverweis (Nothing in Visual Basic)sein, andernfalls muss es CSOM Zeichenfolge. |
|
From |
Wenn deren Wert nicht definiert ist, muss CSOM ein Nullverweis (Nothing in Visual Basic)sein, andernfalls muss es CSOM DateTime. |
|
Until |
Wenn deren Wert nicht definiert ist, muss CSOM ein Nullverweis (Nothing in Visual Basic)sein, andernfalls muss es CSOM DateTime. |
|
ContactInfo |
Wenn deren Wert nicht definiert ist, muss CSOM ein Nullverweis (Nothing in Visual Basic)sein, andernfalls muss es CSOM Zeichenfolge. |
Beispiele
In diesem Codebeispiel fügt ein Element in der Ankündigungsliste auf der angegebenen Website an.
using System;
using Microsoft.SharePoint.Client;
namespace Microsoft.SDK.SharePointFoundation.Samples
{
class ListItemExample
{
static void Main()
{
string siteUrl = "http://MyServer/sites/MySiteCollection";
ClientContext clientContext = new ClientContext(siteUrl);
Web site = clientContext.Web;
List targetList = site.Lists.GetByTitle("Announcements");
ListItemCreationInformation itemCreateInfo = new ListItemCreationInformation();
ListItem newListItem = targetList.AddItem(itemCreateInfo);
newListItem["Title"] = "New Announcement";
newListItem["Body"] = "Hello World!";
newListItem.Update();
clientContext.Load(newListItem);
clientContext.ExecuteQuery();
Console.WriteLine("Announcement created! \n\n"
+ "ID: " + newListItem.Id + "\nTitle: " + newListItem["Title"]);
}
}
}
Threadsicherheit
Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Die Threadsicherheit von Instanzmembern ist nicht gewährleistet.