SP. Поле object (sp.js)

Статья
02/03/2016

Представляет поле списка на веб-сайте Microsoft SharePoint Foundation.

Дата последнего изменения: 6 января 2016 г.

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

var object = new SP.Field()

Элементы

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

Конструктор

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

Конструктор	Описание
Поле	Инициализирует новый экземпляр объекта SP.Field.

Методы

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

Метод	Описание
deleteObject	Получает или задает значение, указывающее, отображаются ли все изменения значения поля в формах списка.
setShowInDisplayForm	Инициализирует новый экземпляр объекта SP.ContentTypeCreationInformation.ShowInDisplayFormShowInDisplayForm
setShowInEditForm	Инициализирует новый экземпляр объекта SP.ContentTypeCreationInformation.ShowInEditFormShowInDisplayForm
setShowInNewForm	Инициализирует новый экземпляр объекта SP.ContentTypeCreationInformation.ShowInNewFormShowInDisplayForm
обновление	Получает ссылку на столбец или поле по указанному индексу в коллекции.
updateAndPushChanges	Получает значение, которое задает зависящий от сайта URL-адрес формы сопоставления рабочих процессов, используемый с шаблоном.
validateSetValue	Получает значение, задающее описание конфигурации определения сайта или шаблона сайта.

Свойства

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

Свойство	Описание
canBeDeleted	Идентификатор экземпляра приложения, представленного данным веб-сайтом.
defaultValue	Получает имя поля или идентификатор списка со сбоем проверки.
Описание	Получает коллекции всех пользователей, которые принадлежат семейству веб-сайтов.
Направление	Получает или задает значение, указывающее порядок чтения поля.
enforceUniqueValues	Получает или задает значение, указывающее, требуется ли уникальность значений полей в столбце списка или библиотеки.
entityPropertyName	Добавляет папку по указанному URL-адресу в коллекцию.
fieldTypeKind	Получает определение роли по указанному индексу в коллекции привязок.
Фильтруемые	Возвращает результат, указывающий, есть ли у текущего пользователя данный набор разрешений.
fromBaseType	Получает объектПолучает значениеBoolean
Группа	Описывает разные этапы извлечения файла вне зависимости от состояния его блокировки.
скрытые	Перезапускает все задания для данного экземпляра приложения (при наличии).
Идентификатор	Задает состояние кэша и настроек страницы.
индексируются	Инициализирует новый экземпляр объекта SP.FieldRatingScale.
internalName	Получает или задает значение, указывающее, используется ли представление списка в качестве мобильного представления по умолчанию.
jsLink	Получает значение, указывающее время последнего изменения элемента, поля или свойства списка. Примечание Перечислены JSLink, свойство не поддерживается в опросе или событий. Календарь SharePoint — это список событий.
readOnlyField	Получает или задает значение, указывающее, доступно ли значение поля только для чтения.
Обязательный	Тип календаря — 2-байтовое целое число, задающее тип календаря, используемого в определенном контексте.
schemaXml	ExecutingWebRequest
schemaXmlWithResourceTokens	Получает схему, которая определяет поле и включает маркеры ресурсов.
область	Расширение даты напоминания об обновлении для настоящего SPSite по дням, указанным в методе WebApplication.UpgradeReminderDelay.
запечатанным	Описывает тип проверки, в которой обнаружен сбой.
возможность сортировки	Получает значение, указывающее, могут ли элементы списка сортироваться по значению поля.
staticName	Получает значение, задающее зависящий от сервера URL-адрес списка или сайта, к которому принадлежит поле.
Заголовок	Инициализирует новый экземпляр SP. Workflow.WorkflowAssociationCollection object (sp.js).
typeAsString	Получает определение роли по указанному индексу в коллекции привязок.
typeDisplayName	Получает или задает значение, которое указывает сведения (в виде пар "имя-значение"), необходимые для получения следующей страницы данных представления списка.
typeShortDescription	Получает значение, задающее имя отдела для субъекта.
validationFormula	Получает или задает значение, указывающее условия проверки данных для значения поля.
validationMessage	Получает разделитель, используемый при группировке разрядов.

Пример

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

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

    var fieldCollection;
    var oneField = null;
    function runCode() {
        var clientContext = SP.ClientContext.get_current();
        if (clientContext != undefined && clientContext != null) {
            var webSite = clientContext.get_web();
            taskList = webSite.get_lists().getByTitle("Tasks");

            fieldCollection = taskList.get_fields();
            this.oneField = fieldCollection.getByInternalNameOrTitle("Title");

            this.oneField.set_description("MyNewFieldDescription");
            this.oneField.update();

            clientContext.load(this.fieldCollection);
            clientContext.load(this.oneField);
            clientContext.executeQueryAsync(Function.createDelegate(this, this.OnLoadSuccess), Function.createDelegate(this, this.OnLoadFailed));
        }
    }

    function OnLoadSuccess(sender, args) {
        var fieldInfo = '';
        fieldInfo += 'Field Title: ' + oneField.get_title() + '\n' + 'Description: ' + oneField.get_description() + '\n';
        alert(fieldInfo);
    }

    function OnLoadFailed(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

Дополнительные сведения см. в разделе Ресурс в виде поля.

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

http://<sitecollection>/<site>/_api/web/lists(listid)/fields(fieldid)

Запросы HTTP

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

Delete.

Синтаксис DELETE

DELETE http://<sitecollection>/<site>/_api/web/lists(listid)/fields(fieldid)

Синтаксис MERGE

MERGE http://<sitecollection>/<site>/_api/web/lists(listid)/fields(fieldid)

Синтаксис POST

POST http://<sitecollection>/<site>/_api/web/lists(listid)/fields(fieldid)

Синтаксис PUT

PUT http://<sitecollection>/<site>/_api/web/lists(listid)/fields(fieldid)

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