SP. ListItem object (sp.js)

Статья
02/03/2016

Представляет элемент или строку списка.

Дата последнего изменения: 9 марта 2015 г.

Область применения: apps for SharePoint | SharePoint Foundation 2013 | SharePoint Server 2013

Содержание
Элементы
Замечания
Конечная точка ресурса REST

var object = new SP.ListItem()

Элементы

Объект ListItem содержит следующие элементы.

Конструктор

Объект ListItem имеет следующий конструктор.

Конструктор	Описание
ListItem	Получает значение, задающее описание шаблона рабочего процесса.

Методы

Объект ListItem содержит следующие методы.

Метод	Описание
deleteObject	Обновляет папку списка с использованием внесенных изменений.
getUserEffectivePermissions	Инициализирует новый экземпляр объекта SP.FileCreationInformation.
getWOPIFrameUrl	Отображаемое имя поставщика удостоверений, зарегистрированное в ферме.
initNonPropertiesFromJson
loadExpandoFields	Инициализирует расширенные свойства элемента списка.
parseAndSetFieldValue	Получает или задает значение, указывающее отображаемое имя нового списка.
Корзина	Перемещает элемент списка в корзину и возвращает идентификатор нового элемента корзины.
refreshLoad	Получает определение роли по указанному индексу в коллекции.
обновление	Получает значение, указывающее, можно ли настроить для сопоставлений рабочих процессов, основанных на этом шаблоне, ручной запуск экземпляров рабочих процессов.
validateUpdateListItem	Проверяет и задает значения указанной коллекции полей для элемента списка.

Properties

Объект ListItem имеет следующие свойства.

Свойство	Описание
attachmentFiles	Указывает коллекцию вложений, связанных с элементом списка.
contentType	Получает или задает значение имени шаблона настраиваемой формы отображения для элементов списка, которым назначен тип контента.
displayName	Инициализирует новый экземпляр объекта UserSharingResult.
effectiveBasePermissions	Объект, которому можно назначить разрешения безопасности.
effectiveBasePermissionsForUI	Инициализирует новый экземпляр объекта SP.ListItemFormUpdateValue.
fieldValues	Получает коллекцию пар "ключ-значение" с именами и значениями полей элемента списка.
fieldValuesAsHtml	Получает или устанавливает формат даты и времени, отображаемых в поле.
fieldValuesAsText	Отменяет каждое выполняющееся в данный момент задание жизненного цикла для экземпляра приложения.
fieldValuesForEdit	Получает или задает значение, указывающей отображаемый текст, который соответствует выбору на шкале оценки, определяющей неприменимый вариант.
Файл	Получает значение, указывающее маркер изменений, который задает измененный объект.
fileSystemObjectType	Получает значение, указывающее, является ли элемент списка файлом или папкой списка.
Папка	Инициализирует новый экземпляр объекта SP.ListItemEntityCollection.
идентификатор.	Получает значение, задающее идентификатор элемента списка.
Элемент	Инициализирует новый экземпляр объекта SP.FileSaveBinaryInformation.
parentList	Задает поле с URL-адресом.

Замечания

Содержит поля CSOM expando, которые соответствуют полей, определенных в родительский список. Имя поля CSOM expando — это имя поля, определенных в списке, а значение поля CSOM expando — значение поля в элементе списка. Следующая таблица определяет сопоставление между типы полей и их значения.

Тип поля	Тип значения CSOM Expando поля	Смысл
Целое число	При его значение не определен, он должен быть CSOM null; в противном случае он должен быть CSOM Int32.	Разрешает целое значение.
Текст	При его значение не определен, он должен быть CSOM null; в противном случае она должна быть строка CSOM.	Разрешает ограниченной длины строки текста.
Примечание	При его значение не определен, он должен быть CSOM null; в противном случае она должна быть строка CSOM.	Разрешает больших объемов текста.
DateTime	При его значение не определен, он должен быть CSOM null; в противном случае значения даты и времени CSOM.	Разрешает полный даты и значения времени, а также только даты значения.
Счетчик	Это должен быть CSOM Int32.	Позволяет последовательно повышающий поле целое число, которое имеет уникальное значение при использовании других значений, которые хранятся в поле в списке. Счетчик используется только для поля идентификатор элемента списка и не предназначен для использования в другом месте.
Варианты	При его значение не определен, он должен быть CSOM null; в противном случае она должна быть строка CSOM.	Позволяет выбрать из набора предложенные значения. Поле выбора поддерживает параметр уровня поля, который указывает, поддерживаются ли значения свободной форме.
Подстановка	При его значение не определен, он должен быть CSOM null; в противном случае он должен быть объект CSOM.	Разрешает ссылку на другой элемент списка. Это поле поддерживает спецификации идентификатора списка для целевого списка. Идентификатор необязательно сайта можно также указан, который указывает сайт из списка, который содержит целевой подстановки.
Boolean	При его значение не определен, он должен быть CSOM null; в противном случае должен быть CSOM Boolean.	Позволяет true или false значение.
Число	При его значение не определен, он должен быть CSOM null; в противном случае должен быть CSOM Double.	Разрешает положительное или отрицательное число. Числовое поле поддерживает поля Настройка уровня используется, чтобы указать число десятичных знаков для отображения.
Денежный	При его значение не определен, он должен быть CSOM null; в противном случае должен быть CSOM Double.	Обеспечивает данных, связанных с валюты. Поле валюты имеет свойство CurrencyLocaleId , который принимает идентификатор языкового стандарта валюты для использования.
URL-адрес	При его значение не определен, он должен быть CSOM null; в противном случае он должен быть объект CSOM.	Разрешает URL-адрес и необязательное описание URL-адреса.
Computed	Не определен	Отображает выходные данные на основе значения других столбцов.
Threading	При его значение не определен, он должен быть CSOM null; в противном случае она должна быть строка CSOM.	Содержит данные о потоковой модели элементов на доске обсуждений.
Guid	При его значение не определен, он должен быть CSOM null; в противном случае он должен быть идентификатор GUID CSOM.	Указывает, что значение поля GUID.
MultiChoice	Когда его значение не определено; Это должен быть CSOM null; в противном случае он должен быть массив CSOM.	Позволяет использовать один или несколько значений из набора указанных вариантов. Поле MultiChoice также может поддерживать произвольных значений.
GridChoice	При его значение не определен, он должен быть CSOM null; в противном случае он должен быть массив CSOM.	Поддержка спецификации несколько номеров шкал в виде списка.
Вычисляемые	Недоступно	Рассчитывается на основе значения других столбцов.
Файл	При его значение не определен, он должен быть CSOM null; в противном случае она должна быть строка CSOM.	Задает ссылку на файл, который можно использовать для получения содержимого, файл.
Вложения	При его значение не определен, он должен быть CSOM null; в противном случае должен быть CSOM Boolean.	Описание, связанное с элементом ли один или несколько файлов. true Если элемент списка содержит вложения и false , если элемент списка не имеет вложений.
Пользователь	При его значение не определен, он должен быть CSOM null; в противном случае он должен быть объект CSOM.	Содержит подстановки для определенного пользователя в список сведений о пользователе.
Recurrence	При его значение не определен, он должен быть CSOM null; в противном случае должен быть CSOM Boolean.	Указывает, содержит ли поле шаблон повторения для элемента.
CrossProjectLink	При его значение не определен, он должен быть CSOM null; в противном случае должен быть CSOM Boolean.	Разрешает ссылку на сайт рабочей области для собраний.
ModStat	При его значение не определен, он должен быть CSOM null; в противном случае он должен быть CSOM int32.	Указывает текущее состояние процесса утверждения в документе.
Ошибка	Не определен	Указывает ошибки. Значение = 24.
ContentTypeId	При его значение не определен, он должен быть CSOM null; в противном случае он должен быть объект CSOM.	Содержит идентификатор типа контента для элемента. ContentTypeId соответствует структуры, определенные в ContentTypeId.
PageSeparator	Недоступно	Заполнитель для разделитель страниц в списке опроса. PageSeparator предназначен только для использования со списком опросов.
ThreadIndex	При его значение не определен, он должен быть CSOM null; в противном случае она должна быть строка CSOM.	Содержит скомпилированной индекс потоков на доске обсуждений.
WorkflowStatus	При его значение не определен, он должен быть CSOM null; в противном случае он должен быть CSOM Int32.	Содержит состояние на выполнение рабочего процесса для определенного элемента.
AllDayEvent	При его значение не определен, он должен быть CSOM null; в противном случае должен быть CSOM Boolean.	Используется только в сочетании с списка событий. true , если элемент является событием на целый день (то есть не происходит во время определенного набора часов в день).
WorkflowEventType	При его значение не определен, он должен быть CSOM null; в противном случае он должен быть CSOM Int32.	Описание типа события журнала рабочего процесса. Для получения дополнительных сведений см WorkflowEventTypeEnumeration
Производственные объекты	При его значение не определен, он должен быть CSOM null; в противном случае он должен быть массив CSOM.	Содержит оборудование или средств группа ресурсов.
FreeBusy	При его значение не определен, он должен быть CSOM null; в противном случае она должна быть строка CSOM.	Содержит сведения о доступности расписания.
Превышени выделения	При его значение не определен, он должен быть CSOM null; в противном случае она должна быть строка CSOM.	Содержит сведения, double резервирование расписания.
Confidential	При его значение не определен, он должен быть CSOM null; в противном случае должен быть CSOM Boolean.	Указывает ли этот обращения можно просматривать только те, которым было отправлено.
WhatsNew	При его значение не определен, он должен быть CSOM null; в противном случае должен быть CSOM Boolean.	Указывает, являются ли текущий личные элементы нового сайта группы.
DueDate	При его значение не определен, он должен быть CSOM null; в противном случае значения даты и времени CSOM.	Содержит дату и время, когда должен быть завершения задачи.
AllowEditing	При его значение не определен, он должен быть CSOM null; в противном случае должен быть CSOM Boolean.	Указывает, может ли пользователь, который не является автором изменять содержимое этого ресурса.
SendTo	При его значение не определен, он должен быть CSOM null; в противном случае это должен быть массив CSOM	Содержит пользователей, которым был отправлен в этом обращения.
Подтверждений	При его значение не определен, он должен быть CSOM null; в противном случае она должна быть строка CSOM.	Содержит сведения о подтверждении из этой обращения.
CallTo	При его значение не определен, он должен быть CSOM null; в противном случае он должен быть массив CSOM.	Содержит получателей, которые необходимо отслеживать эту информацию Примечание.
CallTime	При его значение не определен, он должен быть CSOM null; в противном случае значения даты и времени CSOM.	Содержит дату и время, когда этот вызов.
Whereabout	При его значение не определен, он должен быть CSOM null; в противном случае она должна быть строка CSOM.	Папка пользователя.
От	При его значение не определен, он должен быть CSOM null; в противном случае значения даты и времени CSOM.	Содержит дату и время местонахождений состояние начала.
До	При его значение не определен, он должен быть CSOM null; в противном случае значения даты и времени CSOM.	Содержит дату и время окончания состояние сведения о расположении.
ContactInfo	При его значение не определен, он должен быть CSOM null; в противном случае она должна быть строка CSOM.	Содержит список контактов пользователя.

Пример

В следующем примере создается кнопка input на страницу приложения, который добавляет элемент в список извещений на текущем веб-сайте.

<asp:Content ID="Main" ContentPlaceHolderID="PlaceHolderMain" runat="server">
<script type="text/ecmascript" language="ecmascript">

    function runCode() {

        var clientContext = new SP.ClientContext();
        var targetList = clientContext.get_web().get_lists().getByTitle('Announcements');
        var itemCreateInfo = new SP.ListItemCreationInformation();

        this.newListItem = targetList.addItem(itemCreateInfo);

        newListItem.set_item('Title', 'MyNewAnnouncement');
        newListItem.set_item('Body', 'Hello World!');
        newListItem.update();
        clientContext.load(newListItem);

        clientContext.executeQueryAsync(Function.createDelegate(this, this.onQuerySucceeded), Function.createDelegate(this, this.onQueryFailed));
    }

    function onQuerySucceeded() {

        alert('Announcement created!\n\nId: ' + newListItem.get_id() + '\nTitle: ' + newListItem.get_item('Title'));
    }

    function onQueryFailed(sender, args) {

        alert('Request failed. ' + args.get_message() + '\n' + args.get_stackTrace());
    }

</script>

    <input id="Button1" type="button" value="Run Code" onclick="runCode()" />

</asp:Content>

Конечная точка ресурса REST

Ресурс ListItem более подробные сведения.

Структура URI конечной точки

http://<sitecollection>/<site>/_api/web/lists(listid)/items(itemid)

Запросы HTTP

Этот ресурс поддерживает следующие команды HTTP:

Delete.

Синтаксис DELETE

DELETE http://<sitecollection>/<site>/_api/web/lists(listid)/items(itemid)

Синтаксис MERGE

MERGE http://<sitecollection>/<site>/_api/web/lists(listid)/items(itemid)

Синтаксис POST

POST http://<sitecollection>/<site>/_api/web/lists(listid)/items(itemid)

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