ReportingService2010.CreateItemHistorySnapshot(String, Warning[]) 方法

定义

生成指定目录项的一个项历史记录快照。 此方法适用于Report项类型。

public:
 System::String ^ CreateItemHistorySnapshot(System::String ^ ItemPath, [Runtime::InteropServices::Out] cli::array <ReportService2010::Warning ^> ^ % Warnings);
[System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateItemHistorySnapshot", ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped, RequestNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", ResponseNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", Use=System.Web.Services.Description.SoapBindingUse.Literal)]
[System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)]
[System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")]
public string CreateItemHistorySnapshot (string ItemPath, out ReportService2010.Warning[] Warnings);
[<System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateItemHistorySnapshot", ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped, RequestNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", ResponseNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", Use=System.Web.Services.Description.SoapBindingUse.Literal)>]
[<System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)>]
[<System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")>]
member this.CreateItemHistorySnapshot : string * Warning[] -> string
Public Function CreateItemHistorySnapshot (ItemPath As String, ByRef Warnings As Warning()) As String

参数

ItemPath
String

项的完全限定 URL,其中包括文件名(在 SharePoint 模式下,还有扩展名)。

Warnings
Warning[]

[out] Warning 对象的数组,它列出在报表处理过程中出现的警告。

返回

一个表示快照的日期和时间戳的String。 此字符串用作历史快照的唯一标识符。

属性

注解

下表显示了有关此操作的标头和权限信息。

SOAP 标头用法 (In) TrustedUserHeaderValue

(Out) ServerInfoHeaderValue
本机模式所需的权限 CreateSnapshotExecute
SharePoint 模式所需权限 <xref:Microsoft.SharePoint.SPBasePermissions.EditListItems> 和 <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems>

若要成功生成快照,必须为 catelog 项启用项历史记录。 若要为目录项启用项历史记录,请使用 SetItemHistoryOptions 方法。

如果报表项包含子报表,则子报表中的查询结果集将保留在项历史记录快照中。 在执行报表时传递给报表的报表参数也会保留。

快照仅使用默认参数通过此方法创建。

参数的 ItemPath 长度不能超过 260 个字符;否则,将引发 SOAP 异常,错误代码 为 rsItemLengthExceededed

参数 ItemPath 不能为 null 或空,也不能包含以下保留字符: : ? ; @ & = + $ , \ * > < | . "。 可以使用 /) (正斜杠字符分隔文件夹的完整路径名称中的项目,但不能在文件夹名称的末尾使用它。

适用于