ReportExecutionService.LoadReportDefinition(Byte[], Warning[]) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
根據客戶端提供的報告定義建立報表執行。
public:
ReportExecution2005::ExecutionInfo ^ LoadReportDefinition(cli::array <System::Byte> ^ Definition, [Runtime::InteropServices::Out] cli::array <ReportExecution2005::Warning ^> ^ % warnings);
public ReportExecution2005.ExecutionInfo LoadReportDefinition(byte[] Definition, out ReportExecution2005.Warning[] warnings);
member this.LoadReportDefinition : byte[] * Warning[] -> ReportExecution2005.ExecutionInfo
Public Function LoadReportDefinition (Definition As Byte(), ByRef warnings As Warning()) As ExecutionInfo
參數
- Definition
- Byte[]
一個包含報告定義語言(RDL)的位元組串流。
傳回
一個 ExecutionInfo 包含報告執行資訊的物件。
範例
請參考 Render 範例。
備註
下表顯示此操作的標頭與權限資訊。
| SOAP 標頭的使用 | (在) TrustedUserHeaderValue (出局) ExecutionHeaderValue (出局) ServerInfoHeaderValue |
| 原生模式所需權限 | ReadProperties 在所有子報告 AND ExecuteReportDefinition (系統) |
| SharePoint 模式 必要權限 | <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems> 在所有子報告中 AND <xref:Microsoft.SharePoint.SPBasePermissions.UseRemoteAPIs> |
此方法應在呼叫 Render 報告前先呼叫。
回傳的報告執行需先處理後才能呈現。 會建立一個新的執行,並 ExecutionInfo 以新 ExecutionID 值回傳。
使用此 LoadReportDefinition 方法實例化的報告是暫時性的。 它們不會在報告伺服器命名空間中呈現,且當伺服器會話結束時會被丟棄。
使用此 LoadReportDefinition 方法實例化的報告無法被保護,且不得與其他使用者分享;唯一能存取該報告的使用者是與執行者 LoadReportDefinition 。
此方法不支援帶有相對路徑的子報告與資料來源參考。 不過,也可以使用絕對路徑來目錄項目。