SPListItemCollection.Add-Methode
Erstellt ein Element, aber erfordert die Methode SPListItem.Update , tatsächlich das Element zur Liste hinzuzufügen.
Namespace: Microsoft.SharePoint
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Syntax
'Declaration
Public Function Add As SPListItem
'Usage
Dim instance As SPListItemCollection
Dim returnValue As SPListItem
returnValue = instance.Add()
public SPListItem Add()
Rückgabewert
Typ: Microsoft.SharePoint.SPListItem
Das neue Element.
Hinweise
Um ein Element zu einer Liste hinzuzufügen, rufen Sie die Add -Methode, um ein Listenelement Elemente im Stammverzeichnis der Liste mit einem automatisch generierten Namen zu erstellen, und weisen Sie den Rückgabewert in ein SPListItem -Objekt. Verwenden Sie Indexer auf dieses Objekt für jedes Feld zuweisen bestimmter Werte, und rufen Sie dann die Update -Methode auf das Element, um Änderungen in der Datenbank.
Verwenden Sie list.RootFolder.Files.Add Dateien in einer Dokumentbibliothek hinzuzufügen, wobei list ein SPList -Objekt ist.
Diese Methode gibt eine System.Exception -Ausnahme, wenn eine Dokumentbibliothek zugewiesen.
Beispiele
Im folgenden Beispiel wird eine angegebene Liste ein neues Element hinzugefügt.
Imports System
Imports Microsoft.SharePoint
Module Test
Sub Main()
Using site As SPSite = New SPSite("https://localhost")
Using web As SPWeb = site.OpenWeb()
Dim list As SPList = web.GetList("/lists/announcements")
Dim items As SPListItemCollection = list.Items
Dim item As SPListItem = items.Add()
item(SPBuiltInFieldId.Title) = "A new item!"
item(SPBuiltInFieldId.Body) = "This item was added by a call to the Add method."
item(SPBuiltInFieldId.Expires) = DateTime.Now.AddHours(1)
item.Update()
Dim id As Guid = item.UniqueId
Console.WriteLine(items(id).Title)
End Using
End Using
Console.ReadLine()
End Sub
End Module
using System;
using Microsoft.SharePoint;
namespace Test
{
class Program
{
static void Main(string[] args)
{
using (SPSite site = new SPSite("https://localhost"))
{
using (SPWeb web = site.OpenWeb())
{
SPList list = web.GetList("/lists/announcements");
SPListItemCollection items = list.Items;
SPListItem item = items.Add();
item[SPBuiltInFieldId.Title] = "A new item!";
item[SPBuiltInFieldId.Body] = "This item was added by a call to the Add method.";
item[SPBuiltInFieldId.Expires] = DateTime.Now.AddHours(1);
item.Update();
Guid id = item.UniqueId;
Console.WriteLine(items[id].Title);
}
}
Console.ReadLine();
}
}
}