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.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> |
Если при текущем выполнении при установке значений параметров существует snapshot, она будет очищена, если она не является выполнением или журналом snapshot, что потребует повторного выполнения отчета. Для моментальных снимков выполнения или журнала можно указать значения для параметров, не относящихся к запросу. Обратите внимание, что сервер отчетов не выполняет обработку данных для моментальных снимков выполнения или журнала.
Если указанное значение параметра имеет неправильный тип, метод возвращает ошибку, а параметр не изменяется. Если значение параметра имеет правильный тип, но не является допустимым значением, параметр переходит в MissingValidValue состояние . В обоих случаях попытка отрисовки отчета приведет к ошибке.
Если ParameterLanguage параметр не указан, язык, указанный в заголовке Accepts-Language HTTP. Если для заголовка Accepts-Language HTTP не указан язык, используется язык по умолчанию на сервере отчетов.