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

Метод NEWFIELD

  • Статья

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

Применимо к: SharePoint Foundation 2010

Добавляет поле в список SharePoint.

ПримечаниеПримечание

Метод веб-службы UpdateList(String, XmlNode, XmlNode, XmlNode, XmlNode, String)Этот метод относится к числу нерекомендуемых и может не поддерживаться в будущих версиях. Вместо него необходимо использовать следующий метод веб-службы:.

 
<Method ID="Text">
  <SetList Scope="Request">GUID</SetList>
  <SetVar Name="Cmd">NEWFIELD</SetVar>
  <SetVar Name="FieldXML">&lt;Field Name=&quot;fieldname&quot;
    MaxLength=&quot;Integer&quot; DisplayName=&quot;displayname&quot;
    Description=&quot;text&quot; Type=&quot;Text&quot;/&gt;</SetVar>
  <SetVar Name="AddToDefaultView">[ON|OFF]</SetVar>
  <SetVar Name="owshiddenversion">Integer</SetVar>
</Method>

Параметры

Параметр

Описание

ID = "Text"

Характерная для приложения строка. В редакторе HTML, совместимом с Microsoft Windows SharePoint Services, например Microsoft Office SharePoint Server 2007, строка предоставляет номер последовательности и имя метода.

Scope = "Request"

Если задано значение Request, атрибут Scope задает переменную для области действия заключающего элемента Method, пока переменная не будет изменена другим тегом.

Name = "Cmd"

Должно иметь значение NEWFIELD.

Name = "FieldXML"

XML-описание нового поля. Полный набор доступных атрибутов и значений, которые могут быть включены, см. в определении элемента Field в статье Ключевые схемы языка Collaborative Application Markup Language.

Name = "AddToDefaultView"

Представление — это именованный набор правил, описывающих отображение элементов в списке. Каждый список имеет заданное по умолчанию представление, с ним связанное. Если параметр AddToDefaultView имеет значение ON, поле добавляется к представлению по умолчанию; если параметр имеет значение OFF, поле к представлению не добавляется.

Name = "owshiddenversion"

Это номер текущей версии списка. Команда NEWFIELD действует только в случае, если Windows SharePoint Services и клиентское приложение согласованы в отношении номера версии списка. Таким образом гарантируется, что только один пользователь одновременно может изменять схему списка.

Декодировано

<Method ID="0,NEWFIELDSample">
  <SetList Scope="Request">GUID</SetList>
  <SetVar Name="Cmd">NEWFIELD</SetVar>
  <SetVar Name="FieldXML">&lt;Field Name=&quot;Sample&quot;
    MaxLength=&quot;255&quot; DisplayName=&quot;Sample&quot;
    Description=&quot;sample description&quot; 
        Type=&quot;Text&quot;/&gt;</SetVar>
  <SetVar Name="AddToDefaultView">ON</SetVar>
  <SetVar Name="owshiddenversion">6</SetVar>
</Method>

См. также

Концепции

Формат сообщений об ошибках для SharePoint Foundation