ReportExecutionService.SetExecutionParameters 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::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 ExecutionInfoParâmetros
- Parameters
- ParameterValue[]
Uma matriz de objetos de ParameterValue.
- ParameterLanguage
- String
Um identificador de localidade do .NET Framework.
Retornos
Um objeto ExecutionInfo 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 forem definidos, ele será limpo se não for uma execução ou um histórico instantâneo, o que exigirá que o relatório seja executado novamente. Para instantâneos de execução ou histórico, você pode especificar valores para parâmetros que não são de consulta. Observe que o servidor de relatório não executa o processamento de dados para instantâneos de execução ou histórico.
Se o valor do parâmetro especificado tiver um tipo incorreto, o método retornará um erro e o parâmetro não será alterado. Se o valor do parâmetro tiver o tipo correto, mas não for um valor válido, o parâmetro entrará no MissingValidValue estado . Em ambos os casos, a tentativa de renderizar o relatório causará um erro.
Se ParameterLanguage não for especificado, o idioma especificado no Accepts-Language cabeçalho HTTP. Se nenhum idioma for especificado para o Accepts-Language cabeçalho HTTP, o idioma padrão no servidor de relatório será usado.