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

Метод UPDATEFIELD

  • Статья

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

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

Изменяет схему существующего поля в списке SharePoint.

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

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

 
<Method ID="Text">
  <SetList Scope="Request">GUID</SetList>
  <SetVar Name="Cmd">UPDATEFIELD</SetVar>
  <SetVar Name="FieldXML">&lt;Field ColName=&quot;tp_Title&quot; 
    Type=&quot;Text&quot; Name=&quot;Title&quot; DisplayName=&quot;Title&quot; 
    FromBaseType=&quot;TRUE&quot; MaxLength=&quot;255&quot; 
    Description=&quot;this is an update&quot;/&gt;
  </SetVar>
  <SetVar Name="owshiddenversion">Integer</SetVar>
</Method>

Параметры

Параметр

Описание

ID = "Text"

Строка, предназначенная для конкретного приложения. В редакторе HTML, совместимом с Microsoft Windows SharePoint Services, например Microsoft Office SharePoint Designer 2007, эта строка представляет порядковый номер и имя метода.

Scope = "Request"

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

Name = "Cmd"

Необходимо установить значение UPDATEFIELD.

Name = "FieldXML"

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

Name = "owshiddenversion"

Текущий номер версии списка. Команда UPDATEFIELD работает, только если Windows SharePoint Services и клиентское приложение используют список с одним номером версии. Таким образом, одновременно схему списка может изменять только один пользователь.

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

<Method ID="0,UPDATEFIELDTitle">
  <SetList Scope="Request">GUID</SetList>
  <SetVar Name="Cmd">UPDATEFIELD</SetVar>
  <SetVar Name="FieldXML">&lt;Field ColName=&quot;tp_Title&quot; 
    Type=&quot;Text&quot; Name=&quot;Title&quot; 
        DisplayName=&quot;Title&quot; 
    FromBaseType=&quot;TRUE&quot; MaxLength=&quot;255&quot; 
    Description=&quot;this is an update&quot;/&gt;
  </SetVar>
  <SetVar Name="owshiddenversion">13</SetVar>
</Method>