Batch 元素
Batch 元素
提供对 HTTP 协议中命令的批处理。Batch 元素必须至少包含一个 Method 元素。Batch 元素允许客户端应用程序一次性向服务器传送多个命令。
属性 | 说明 |
---|---|
ListVersion |
可选属性,类型为 Integer。指定列表的版本号。 |
OnError |
可选。以下是可能的值:
|
Version |
可选属性,类型为 String。指定正在服务器上运行的 Windows SharePoint Services 的版本号。版本号包含四个整数,格式为 N.N.N.NNNN,它们表示产品的主版本、次版本、阶段版本和增量版本。 |
ViewName |
可选属性,类型为 Guid。指定视图的 GUID。 |
示例
<?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>
<?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>
<?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>