ReportingService2010.CreateReportEditSession(String, String, Byte[], Warning[]) ReportingService2010.CreateReportEditSession(String, String, Byte[], Warning[]) ReportingService2010.CreateReportEditSession(String, String, Byte[], Warning[]) Method


在报表服务器数据库中创建新的报表编辑会话。 Creates a new report edit session in the report server database.

 System::String ^ CreateReportEditSession(System::String ^ Report, System::String ^ Parent, cli::array <System::Byte> ^ Definition, [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 CreateReportEditSession (string Report, string Parent, byte[] Definition, out ReportService2010.Warning[] Warnings);
Public Function CreateReportEditSession (Report As String, Parent As String, Definition As Byte(), ByRef Warnings As Warning()) As String
String String String

要将编辑会话与其关联的报表的名称。 The name of the report with which to associate the edit session.

String String String

项的路径。 The path to an item. 可以是文件夹或 SharePoint 库。 This can be a folder or a SharePoint library.


一个包含与编辑会话关联的报表的报表定义语言 (RDL) 的字节数组。 A byte array that contains the report definition language (RDL) of the report associated with the edit session.


[out] 一个 Warning 对象的数组,该数组说明在创建报表编辑会话期间出现的所有警告。 [out] An array of Warning objects that describes any warnings that occurred during the creation of the report edit session.


一个标识编辑会话的string A string that identifies the edit session.


下表显示了有关此操作的标头和权限信息。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 ExecuteReportDefinition AND,具体情况取决于:ExecuteReportDefinition AND, depending on the situation:

SharePoint 模式所需的权限SharePoint Mode Required Permissions 需要的系统属性EnableLoadReportDefinition设置为trueAND,具体取决于这种情况:Needs the system property EnableLoadReportDefinition set to true AND, depending on the situation:

  • 如果Parent为空或null: 没有所需的多个权限If Parent is empty or null: No more permission required
  • 如果Parent存在,但Report不存在:AddListItemsParentANDViewListItems对数据源和数据集定义中 DefinitionIf Parent exists, but Report does not exist: AddListItems on Parent AND ViewListItems on data sources and datasets defined in Definition
  • 如果这两个ParentReport存在: 与上面相同 AND 下列权限的所有Report:If both Parent and Report exists: same as above AND all of the following permissions on Report:

如果指定的文件夹或文档库不存在,则会发生错误。An error occurs if the specified folder or document library does not exist.

如果报表中指定Report参数不存在在指定位置的值Report设置全局 !在编辑会话的 RDL 报表名。If the report specified in the Report parameter does not exist at the specified location, the value of Report sets the Globals!ReportName in the RDL for the edit session.

调用DeleteItem方法来删除报表编辑会话中,传递EditSessionID作为参数传递给DeleteItem方法。Call the DeleteItem method to delete the report edit session, passing the EditSessionID as a parameter to the DeleteItem method.

定义不能包含基于表达式的连接字符串。Definition cannot include an expression-based connection string. 不,rsInvalidParameterValue此方法返回。When it does, the rsInvalidParameterValue is returned by this method.

默认情况下,报表的编辑会话从最后一次使用,使用户能够在缓存中的时间较长时间保留大量的数据设置为 7200 秒 (2 小时)。By default, report edit sessions are set to 7200 seconds (2 hours) from last use, making it possible for users to keep a large amount of data in the cache for a prolonged period of time. 在某些使用情况模式中,这可能导致较大的负载RSTempDB数据库和报表服务器。In some usage patterns, this could lead to a larger load on the RSTempDB database and the report server. 在这些情况下应考虑使用LoadReportIn these cases you should consider using LoadReport.