ReportExecutionService.SetExecutionParameters 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
設定並驗證與目前報告執行相關的參數值。
public:
ReportExecution2005::ExecutionInfo ^ SetExecutionParameters(cli::array <ReportExecution2005::ParameterValue ^> ^ Parameters, System::String ^ ParameterLanguage);public ReportExecution2005.ExecutionInfo SetExecutionParameters(ReportExecution2005.ParameterValue[] Parameters, string ParameterLanguage);member this.SetExecutionParameters : ReportExecution2005.ParameterValue[] * string -> ReportExecution2005.ExecutionInfoPublic Function SetExecutionParameters (Parameters As ParameterValue(), ParameterLanguage As String) As ExecutionInfo參數
- Parameters
- ParameterValue[]
ParameterValue 物件的陣列。
- ParameterLanguage
- String
一個 .NET Framework 的區域識別碼。
傳回
一個 ExecutionInfo 包含新執行的物件。
備註
下表顯示此操作的標頭與權限資訊。
| SOAP 標頭的使用 | （在） TrustedUserHeaderValue （在） ExecutionHeaderValue （出局） ServerInfoHeaderValue |
| 原生模式所需權限 | 關於主報告及所有子報告： ReadProperties 以及 ExecuteAndView |
| SharePoint 模式 必要權限 | 關於主報告及所有子報告： <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems> |
如果當前執行中參數值設定時有快照，若該快照不是執行或歷史快照，則該快照將被清除，這時報告將需重新執行。 對於執行快照或歷史快照，你可以指定非查詢參數的值。 請注意，報告伺服器不會執行執行或歷史快照的資料處理。
如果你指定的參數值類型錯誤，方法會回傳錯誤，且參數不會被更改。 若參數值型別正確但非有效值，則該參數進入 MissingValidValue 狀態。 在這兩種情況下，嘗試呈現報告都會造成錯誤。
若 ParameterLanguage 未指定，則使用 HTTP 標頭中 Accepts-Language 指定的語言。 若 HTTP 標頭未指定 Accepts-Language 語言，則使用報告伺服器上的預設語言。