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 AND ExecuteAndView |
| SharePoint 模式 必要权限 | 关于主报告及所有子报告： <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems> |
如果当前执行中存在快照，且参数值设置时存在，若非执行或历史快照，则该快照将被清除，这需要再次执行报告。 对于执行快照或历史快照，你可以指定非查询参数的值。 注意，报告服务器不进行执行或历史快照的数据处理。
如果你指定的参数值类型错误，方法会返回错误，且参数不会被更改。 如果参数值类型正确但不是有效值，则该参数进入 MissingValidValue 状态。 在这两种情况下，尝试呈现报告都会引起错误。
如果 ParameterLanguage 未指定，则使用HTTP头部指定的 Accepts-Language 语言。 如果HTTP头部未指定 Accepts-Language 语言，则使用报告服务器上的默认语言。