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