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.ExecutionInfo
Public Function SetExecutionParameters (Parameters As ParameterValue(), ParameterLanguage As String) As ExecutionInfo
參數
- Parameters
- ParameterValue[]
ParameterValue 物件的陣列。
- ParameterLanguage
- String
.NET Framework 地區設定識別碼。
傳回
包含新執行的 ExecutionInfo 物件。
備註
下表顯示標頭以及有關這項作業的權限資訊。
| SOAP 標頭使用方式 | (In) TrustedUserHeaderValue (In) ExecutionHeaderValue (Out) ServerInfoHeaderValue |
| 原生模式所需的許可權 | 在主報表和所有子報表上: ReadProperties 和 ExecuteAndView |
| SharePoint 模式的必要許可權 | 在主報表和所有子報表上: ViewListItems |
如果設定參數值時,目前執行中有快照集,則會在不是執行或歷程記錄快照集時將其清除,這將需要再次執行報表。 針對執行或記錄快照集,您可以指定非查詢參數的值。 請注意,報表伺服器不會針對執行或記錄快照集執行資料處理。
如果您指定的參數值具有不正確的類型,此方法將會傳回錯誤,而且不會變更參數。 如果參數值具有正確的類型,但不是有效的值,則參數會進入 MissingValidValue 狀態。 在這兩種情況下,嘗試轉譯報表將會造成錯誤。
如果 ParameterLanguage 未指定,則為 HTTP 標頭中指定的語言 Accepts-Language 。 如果未指定 Accepts-Language HTTP 標頭的語言,則會使用報表伺服器上的預設語言。