ReportExecutionService.SetExecutionParameters 方法

定義

設定並驗證與目前報表執行相關聯的參數值。

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

包含新執行的 ExecutionInfo 物件。

備註

下表顯示標頭以及有關這項作業的權限資訊。

SOAP 標頭使用方式 (In) TrustedUserHeaderValue

(In) ExecutionHeaderValue

(Out) ServerInfoHeaderValue
原生模式所需的許可權 在主報表和所有子報表上: ReadPropertiesExecuteAndView
SharePoint 模式的必要許可權 在主報表和所有子報表上: ViewListItems

如果設定參數值時,目前執行中有快照集,則會在不是執行或歷程記錄快照集時將其清除,這將需要再次執行報表。 針對執行或記錄快照集,您可以指定非查詢參數的值。 請注意,報表伺服器不會針對執行或記錄快照集執行資料處理。

如果您指定的參數值具有不正確的類型,此方法將會傳回錯誤,而且不會變更參數。 如果參數值具有正確的類型,但不是有效的值,則參數會進入 MissingValidValue 狀態。 在這兩種情況下,嘗試轉譯報表將會造成錯誤。

如果 ParameterLanguage 未指定,則為 HTTP 標頭中指定的語言 Accepts-Language 。 如果未指定 Accepts-Language HTTP 標頭的語言,則會使用報表伺服器上的預設語言。

適用於