UPDATEFIELD 方法

上次修改时间: 2015年3月9日

适用范围: SharePoint Foundation 2010

修改 SharePoint 列表中现有字段的架构。

备注

此方法已被弃用,在以后的版本中可能不受支持。请改用以下 Web 服务方法:UpdateList(String, XmlNode, XmlNode, XmlNode, XmlNode, String) Web 服务方法。

<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"

特定于应用程序的字符串。在与 Microsoft Windows SharePoint Services 兼容的 HTML 编辑器(如 Microsoft Office SharePoint Designer 2007)中,该字符串提供方法的序号和名称。

Scope = "Request"

当设置为 Request 时,Scope 属性将为封闭的 Method 元素的作用域设置变量,除非该变量已被另一个标记更改。

Name = "Cmd"

必须设置为 UPDATEFIELD。

Name = "FieldXML"

更新字段的 XML 说明。有关可能包含的一整套可用属性和值,请参阅协作应用程序标记语言核心架构中的 Field 元素。

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>