SPListItemCollection.Add - Méthode
Crée un élément, mais nécessite que la méthode SPListItem.Update pour ajouter l'élément à la liste.
Espace de noms : Microsoft.SharePoint
Assembly : Microsoft.SharePoint (dans Microsoft.SharePoint.dll)
Syntaxe
'Déclaration
Public Function Add As SPListItem
'Utilisation
Dim instance As SPListItemCollection
Dim returnValue As SPListItem
returnValue = instance.Add()
public SPListItem Add()
Valeur renvoyée
Type : Microsoft.SharePoint.SPListItem
Le nouvel élément.
Remarques
Pour ajouter un élément à une liste, appelez la méthode Add pour créer un élément de liste nonfolder dans la racine de la liste avec un nom généré automatiquement et attribuer la valeur de retour pour un objet SPListItem . Utilisez des indexeurs sur cet objet pour chaque champ pour attribuer des valeurs spécifiques et ensuite appeler la méthode Update sur l'élément pour rendre effectifs les changements dans la base de données.
list.RootFolder.Files.Add permet d'ajouter des fichiers à une bibliothèque de documents, où list est un objet SPList .
Cette méthode renvoie une exception System.Exception appliquée à une bibliothèque de documents.
Exemples
L'exemple suivant ajoute un nouvel élément à une liste spécifiée.
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();
}
}
}