ReportingService2010.CreateItemHistorySnapshot(String, Warning[]) Method


生成指定目录项的一个项历史记录快照。Generates an item history snapshot of a specified catalog item. 此方法适用于Report项类型。This method applies to the Report item type.

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



项的完全限定 URL,其中包括文件名(在 SharePoint 模式下,还有扩展名)。The fully qualified URL of the item including the file name and, in SharePoint mode, the extension.


[out] Warning 对象的数组,它列出在报表处理过程中出现的警告。[out] An array of Warning objects that lists warnings that occurred during report processing.



一个表示快照的日期和时间戳的StringA String that represents the date and time stamp of the snapshot. 此字符串用作历史快照的唯一标识符。This string is used as a unique identifier for the historical snapshot.



下表显示了有关此操作的标头和权限信息。The table below shows header and permissions information on this operation.

SOAP 标头用法SOAP Header Usage (In) TrustedUserHeaderValue(In) TrustedUserHeaderValue

(Out) ServerInfoHeaderValue(Out) ServerInfoHeaderValue
纯模式所需的权限Native Mode Required Permissions CreateSnapshotExecuteCreateSnapshot AND Execute
SharePoint 模式所需的权限SharePoint Mode Required Permissions EditListItemsViewListItemsEditListItems AND ViewListItems

若要成功生成快照,必须为 catelog 项启用项历史记录。For the snapshot to be generated successfully, item history must be enabled for the catelog item. 若要启用目录项的项历史记录,请使用 SetItemHistoryOptions 方法。To enable item history for a catalog item, use the SetItemHistoryOptions method.

如果报表项包含子报表,则子报表中的查询结果集将保留在项历史记录快照中。If a report item contains subreports, query result sets from the subreports are persisted in the item history snapshot. 还将保留在执行报表时传递给报表的报表参数。Report parameters that are passed to the report at the time the report is executed are also persisted.

仅使用默认参数即可通过此方法创建快照。Snapshots are created by this method with default parameters only.

参数的长度 ItemPath 不能超过260个字符; 否则,将引发带有错误代码RSITEMLENGTHEXCEEDED的 SOAP 异常。The length of the ItemPath parameter cannot exceed 260 characters; otherwise, a SOAP exception is thrown with the error code rsItemLengthExceeded.

ItemPath参数不能为 null 或为空,也不能包含以下保留字符: : ? ; @ & = + $ , \ * > < | . "The ItemPath parameter cannot be null or empty or contain the following reserved characters: : ? ; @ & = + $ , \ * > < | . ". 您可以使用正斜杠字符(/)来分隔文件夹的完整路径名称中的项,但不能在文件夹名称的末尾使用。You can use the forward slash character (/) to separate items in the full path name of the folder, but you cannot use it at the end of the folder name.

Applies to