del método SPListItemCollection.Add
Crea un elemento, pero requiere el método SPListItem.Update para agregar el elemento a la lista.
Espacio de nombres: Microsoft.SharePoint
Ensamblado: Microsoft.SharePoint (en Microsoft.SharePoint.dll)
Sintaxis
'Declaración
Public Function Add As SPListItem
'Uso
Dim instance As SPListItemCollection
Dim returnValue As SPListItem
returnValue = instance.Add()
public SPListItem Add()
Valor devuelto
Tipo: Microsoft.SharePoint.SPListItem
El nuevo elemento.
Comentarios
Para agregar un elemento a una lista, llame al método Add para crear un elemento de lista no sean carpetas en la raíz de la lista con un nombre generado automáticamente y asignar el valor devuelto para un objeto SPListItem . Utilice los indizadores en este objeto para cada campo para asignar valores específicos y, a continuación, llamar al método Update en el elemento a los cambios de efecto en la base de datos.
Utilice list.RootFolder.Files.Add para agregar archivos a una biblioteca de documentos, donde list es un objeto SPList .
Este método devuelve una excepción System.Exception si se aplica a una biblioteca de documentos.
Ejemplos
En el siguiente ejemplo se agrega un nuevo elemento a una lista especificada.
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();
}
}
}