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 标头用法 | (In) TrustedUserHeaderValue (In) ExecutionHeaderValue (Out) ServerInfoHeaderValue |
| 本机模式所需的权限 | 在main报表和所有子报表上： ReadProperties ANDExecuteAndView |
| SharePoint 模式所需权限 | 在main报表和所有子报表上：<xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems> |
如果在设置参数值时当前执行中存在快照，则如果不是执行或历史记录快照，则会清除该快照，这将要求再次执行报表。 对于执行或历史记录快照，可以为非查询参数指定值。 请注意，报表服务器不对执行或历史记录快照执行数据处理。
如果指定的参数值的类型不正确，则 方法将返回错误，并且参数不会更改。 如果参数值具有正确的类型，但不是有效的值，则参数将进入 状态 MissingValidValue 。 在这两种情况下，尝试呈现报表都会导致错误。
如果未 ParameterLanguage 指定 ，则为 HTTP 标头中指定的 Accepts-Language 语言。 如果未为 Accepts-Language HTTP 标头指定任何语言，则使用报表服务器上的默认语言。