Поделиться через


Метод SPListItemCollection.Add

Создает элемент, но требует, чтобы метод SPListItem.Update для добавления элемента в список.

Пространство имен:  Microsoft.SharePoint
Сборка:  Microsoft.SharePoint (в Microsoft.SharePoint.dll)

Синтаксис

'Декларация
Public Function Add As SPListItem
'Применение
Dim instance As SPListItemCollection
Dim returnValue As SPListItem

returnValue = instance.Add()
public SPListItem Add()

Возвращаемое значение

Тип: Microsoft.SharePoint.SPListItem
Новый элемент.

Замечания

Чтобы добавить элемент в список, вызовите метод Add , чтобы создать элемент списка nonfolder в корне списка автоматически и присвоить возвращаемое значение объекта SPListItem . Используйте индексаторы на этом объекте для каждого поля, для назначения конкретных значений, а затем вызвать метод Update для элемента эффект изменения в базе данных.

Позволяет добавить файлы в библиотеку документов, где находится объект SPListlistlist.RootFolder.Files.Add .

Данный метод возвращает исключение System.Exception , если применяется к библиотеке документов.

Примеры

Следующий пример добавляет новый элемент в указанном списке.

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();
        }
    }
}

См. также

Справочные материалы

SPListItemCollection класс

Элементы SPListItemCollection

Перегрузка Add

Пространство имен Microsoft.SharePoint