ReportExecutionService.SetExecutionParameters2 Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Define e valida valores de parâmetros associados à execução do relatório atual.
public:
ReportExecution2005::ExecutionInfo2 ^ SetExecutionParameters2(cli::array <ReportExecution2005::ParameterValue ^> ^ Parameters, System::String ^ ParameterLanguage);
public ReportExecution2005.ExecutionInfo2 SetExecutionParameters2 (ReportExecution2005.ParameterValue[] Parameters, string ParameterLanguage);
member this.SetExecutionParameters2 : ReportExecution2005.ParameterValue[] * string -> ReportExecution2005.ExecutionInfo2
Public Function SetExecutionParameters2 (Parameters As ParameterValue(), ParameterLanguage As String) As ExecutionInfo2
Parâmetros
- Parameters
- ParameterValue[]
Uma matriz de objetos de ParameterValue.
- ParameterLanguage
- String
Um identificador de localidade do .NET Framework.
Retornos
Um objeto ExecutionInfo2 que contém a nova execução.
Comentários
A tabela a seguir mostra o cabeçalho e as informações de permissão sobre esta operação.
Uso do cabeçalho SOAP | (In) TrustedUserHeaderValue (In) ExecutionHeaderValue (Out) ServerInfoHeaderValue |
Permissões necessárias do modo nativo | No relatório main e todos os sub-relatórios: ReadProperties ANDExecuteAndView |
Permissões necessárias do modo do SharePoint | No relatório main e todos os sub-relatórios:<xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems> |
Se houver um instantâneo na execução atual quando os valores de parâmetro usados na consulta forem definidos, ele será limpo (se não for uma execução ou um histórico instantâneo). Definir parâmetros que não sejam de consulta não fará com que o instantâneo seja limpo, mas exigirá processamento antes que ele possa ser renderizado.
Se os parâmetros não passarem na validação, o método retornará um erro e os valores de parâmetro não serão alterados.
Se ParameterLanguage
for especificado, os parâmetros serão interpretados nessa linguagem. Se ParameterLanguage
não for especificado, o comportamento padrão será usado.
Não é possível especificar parâmetros para instantâneos de execução ou histórico.