ReportingService2010.CreateItemHistorySnapshot(String, Warning[]) ReportingService2010.CreateItemHistorySnapshot(String, Warning[]) 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);
Public Function CreateItemHistorySnapshot (ItemPath As String, ByRef Warnings As Warning()) As String
String String 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.


AString表示快照的日期和时间戳。 A 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

已成功生成快照,必须启用项历史记录,全文目录项。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 个字符; 否则,将 SOAP 异常引发,错误代码rsItemLengthExceededThe 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.