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 |
如果在设置参数值时,当前执行中存在快照,则如果快照不是执行或历史记录快照,则将清除快照,这将要求再次执行报表。 对于执行快照或历史记录快照,您可以指定非查询参数的值。 请注意,Report Server 不对执行或历史记录快照执行数据处理。
如果指定的参数值的类型不正确,则该方法将返回错误,并且不会更改参数。 如果参数值具有正确的类型,但不是有效的值,则参数将进入 MissingValidValue 状态。 在这两种情况下,尝试呈现报表将导致错误。
如果 ParameterLanguage 未指定,则为 HTTP 标头中指定的语言 Accepts-Language 。 如果没有为 Accepts-Language HTTP 标头指定语言,则使用 Report Server 上的默认语言。