CreateReportEditSession 方法

在報表伺服器資料庫中建立新的報表編輯工作階段。

命名空間：  ReportService2010
組件：  ReportService2010 (在 ReportService2010.dll 中)

語法

'宣告
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateReportEditSession", RequestNamespace := "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",  _
    ResponseNamespace := "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",  _
    Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
<SoapHeaderAttribute("ServerInfoHeaderValue", Direction := SoapHeaderDirection.Out)> _
<SoapHeaderAttribute("TrustedUserHeaderValue")> _
Public Function CreateReportEditSession ( _
    Report As String, _
    Parent As String, _
    Definition As Byte(), _
    <OutAttribute> ByRef Warnings As Warning() _
) As String
'用途
Dim instance As ReportingService2010
Dim Report As String
Dim Parent As String
Dim Definition As Byte()
Dim Warnings As Warning()
Dim returnValue As String

returnValue = instance.CreateReportEditSession(Report, _
    Parent, Definition, Warnings)

[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateReportEditSession", RequestNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    ResponseNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
[SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)]
[SoapHeaderAttribute("TrustedUserHeaderValue")]
public string CreateReportEditSession(
    string Report,
    string Parent,
    byte[] Definition,
    out Warning[] Warnings
)

[SoapDocumentMethodAttribute(L"https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateReportEditSession", RequestNamespace = L"https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    ResponseNamespace = L"https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    Use = SoapBindingUse::Literal, ParameterStyle = SoapParameterStyle::Wrapped)]
[SoapHeaderAttribute(L"ServerInfoHeaderValue", Direction = SoapHeaderDirection::Out)]
[SoapHeaderAttribute(L"TrustedUserHeaderValue")]
public:
String^ CreateReportEditSession(
    String^ Report, 
    String^ Parent, 
    array<unsigned char>^ Definition, 
    [OutAttribute] array<Warning^>^% Warnings
)

[<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateReportEditSession", RequestNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    ResponseNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)>]
[<SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)>]
[<SoapHeaderAttribute("TrustedUserHeaderValue")>]
member CreateReportEditSession : 
        Report:string * 
        Parent:string * 
        Definition:byte[] * 
        Warnings:Warning[] byref -> string 

public function CreateReportEditSession(
    Report : String, 
    Parent : String, 
    Definition : byte[], 
    Warnings : Warning[]
) : String

參數

• Report
  型別：System. . :: . .String
  報表名稱，使用此名稱與編輯工作階段產生關聯。

• Parent
  型別：System. . :: . .String
  項目的路徑。這可以是資料夾或 SharePoint 文件庫。

• Definition
  型別：array<System. . :: . .Byte> [] () [] []
  位元組陣列，其中包含與編輯工作階段相關聯的報表定義語言 (RDL)。

• Warnings
  型別：array<ReportService2010. . :: . .Warning> [] () [] []%
  [out] Warning 物件的陣列，描述在建立報表編輯工作階段期間所發生的任何警告。

傳回值

型別：System. . :: . .String
識別編輯工作階段的 string。

備註

The table below shows header and permissions information on this operation.

SOAP Header Usage	(In) TrustedUserHeaderValue (Out) ServerInfoHeaderValue
Native Mode Required Permissions	ExecuteReportDefinition AND, depending on the situation: If Parent is empty or null Nothing nullptr unit null 參考 (在 Visual Basic 中為 Nothing) : No more permission required If Parent exists, but Report does not exist: CreateReport on Parent AND ReadProperties on data sources defined in Definition AND ReadProperties on datasets defined in Definition If both Parent and Report exists: same as above AND all of the following permissions on Report: ReadDatasource ReadProperties UpdateProperties ReadReportDefinition UpdateReportDefinition ExecuteAndView
SharePoint Mode Required Permissions	Needs the system property EnableLoadReportDefinition set to true AND, depending on the situation: If Parent is empty or null Nothing nullptr unit null 參考 (在 Visual Basic 中為 Nothing) : No more permission required If Parent exists, but Report does not exist: AddListItems()()()() on Parent AND ViewListItems()()()() on data sources and datasets defined in Definition If both Parent and Report exists: same as above AND all of the following permissions on Report: OpenItems()()()() ViewListItems()()()() EidListItems()()()()

An error occurs if the specified folder or document library does not exist.

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.

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. When it does, the rsInvalidParameterValue is returned by this method.

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. In some usage patterns, this could lead to a larger load on the RSTempDB database and the report server. In these cases you should consider using LoadReport.

請參閱

參考

ReportingService2010 類別

ReportService2010 命名空間