Batch 元素

Batch 元素

提供对 HTTP 协议中命令的批处理。Batch 元素必须至少包含一个 Method 元素。Batch 元素允许客户端应用程序一次性向服务器传送多个命令。

属性	说明
ListVersion	可选属性，类型为 Integer。指定列表的版本号。
OnError	可选。以下是可能的值： Return — 在遇到第一个错误之后，停止执行任何方法。此值为默认值。 Continue — 在遇到错误后，继续执行后续方法。
Version	可选属性，类型为 String。指定正在服务器上运行的 Windows SharePoint Services 的版本号。版本号包含四个整数，格式为 N.N.N.NNNN，它们表示产品的主版本、次版本、阶段版本和增量版本。
ViewName	可选属性，类型为 Guid。指定视图的 GUID。

示例

下面的代码示例（如果该示例包含在 HTTP 协议内）将从服务器返回一个名为“Documents”的列表。

<?xml version="1.0" encoding="UTF-8"?>
<ows:Batch Version="6.0.2.5608" OnError="Return">
  <Method ID="0,ExportList">
    <SetList Scope="Request">Documents</SetList>
    <SetVar Name="Cmd">ExportList</SetVar>
  </Method>
</ows:Batch>

用于在 Windows SharePoint Services 中发出多个请求的语法如下所示：

POST /[Path/][Subweb/]_vti_bin/_vti_aut/owssvr.dll?Cmd=DisplayPost
<?xml version="1.0" encoding="UTF-8"?>
<ows:Batch OnError="Return">
  <Method ID="String">
    <SetVar Name="Cmd">Method1_name</SetVar>
    <SetVar Name="Parameter1">Value1</SetVar>
      .
      .
      .
    <SetVar Name="ParameterN">ValueN</SetVar>
  </Method>
  <Method ID="String">
    <SetVar Name="Cmd">Method2_name</SetVar>
    <SetVar Name="Parameter1">Value1</SetVar>
      .
      .
      .
    <SetVar Name="ParameterN">ValueN</SetVar>
  </Method>
      .
      .
      .
  <Method ID="String">
    <SetVar Name="Cmd">MethodN_name</SetVar>
    <SetVar Name="Parameter1">Value1</SetVar>
      .
      .
      .
    <SetVar Name="ParameterN">ValueN</SetVar>
  </Method>
</ows:Batch>

在下面的示例中，Batch 元素用于创建名为“Meeting Topics”和“Volunteers”的两个自定义列表。

POST /STSServer1/_vti_bin/_vti_aut/owssvr.dll?Cmd=DisplayPost

<?xml version="1.0" encoding="UTF-8"?>
<ows:Batch OnError="Return">
  <Method ID="0,NewList">
    <SetVar Name="Cmd">NewList</SetVar>
    <SetVar Name="ListTemplate">100</SetVar>
    <SetVar Name="Title">Meeting Topics</SetVar>
  </Method>
  <Method ID="1,NewList">
    <SetVar Name="Cmd">NewList</SetVar>
    <SetVar Name="ListTemplate">100</SetVar>
    <SetVar Name="Title">Volunteers</SetVar>
  </Method>
</ows:Batch>