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.ExecutionInfo
Public Function SetExecutionParameters (Parameters As ParameterValue(), ParameterLanguage As String) As ExecutionInfo
Параметры
- Parameters
- ParameterValue[]
Массив объектов ParameterValue.
- ParameterLanguage
- String
Идентификатор локализации .NET Framework.
Возвращаемое значение
Объект, ExecutionInfo содержащий новое выполнение.
Комментарии
В таблице ниже показана информация о заголовках и правах доступа к этой операции.
| Использование разъёма SOAP | (В) TrustedUserHeaderValue (В) ExecutionHeaderValue (Выход) ServerInfoHeaderValue |
| Необходимые разрешения для нативного режима | О основном отчёте и всех подотчетах: ReadProperties И ExecuteAndView |
| Требуются разрешения для режима SharePoint | О основном отчёте и обо всех подотчетах: <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems> |
Если в текущем выполнении при установке значений параметров существует снимок, он будет очищен, если это не выполнение или снимок истории, что потребует повторного выполнения отчета. Для снимков исполнения или истории можно задать значения для параметров, не связанных с запросом. Обратите внимание, что сервер отчетов не выполняет обработку данных для выполнения или снимков истории.
Если указанное вами значение параметра имеет неправильный тип, метод вернёт ошибку, и параметр не меняется. Если значение параметра имеет правильный тип, но не является действительным, параметр входит в MissingValidValue состояние. В обоих случаях попытка отрендерить отчёт приведёт к ошибке.
Если ParameterLanguage не указано, то язык, указанный в Accepts-Language заголовке HTTP. Если для заголовка HTTP не указан Accepts-Language язык, используется язык по умолчанию на сервере отчетов.