ReportExecutionService.SetExecutionParameters Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Imposta e convalida i valori dei parametri associati all'esecuzione del report corrente.
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 ExecutionInfoParametri
- Parameters
- ParameterValue[]
Matrice di oggetti ParameterValue.
- ParameterLanguage
- String
Identificatore delle impostazioni locali di .NET Framework.
Restituisce
Oggetto ExecutionInfo contenente la nuova esecuzione.
Commenti
Nella tabella seguente vengono mostrate le informazioni sull'intestazione e sulle autorizzazioni relative a questa operazione.
| Utilizzo intestazione SOAP | (In) TrustedUserHeaderValue (In) ExecutionHeaderValue (Out) ServerInfoHeaderValue |
| Autorizzazioni necessarie per la modalità nativa | Nel report principale e in tutti i sottoreport: ReadProperties AND ExecuteAndView |
| Autorizzazioni necessarie per la modalità SharePoint | Nel report principale e in tutti i sottoreport: <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems> |
Se un snapshot esiste nell'esecuzione corrente quando vengono impostati i valori dei parametri, verrà cancellato se non è un'esecuzione o uno snapshot della cronologia, che richiederà l'esecuzione del report di nuovo. Per gli snapshot di esecuzione o cronologia, è possibile specificare i valori per i parametri non di query. Si noti che il server di report non esegue l'elaborazione dei dati per gli snapshot di esecuzione o cronologia.
Se il valore del parametro specificato ha un tipo non corretto, il metodo restituirà un errore e il parametro non verrà modificato. Se il valore del parametro ha il tipo corretto, ma non è un valore valido, il parametro entra nello MissingValidValue stato . In entrambi i casi, il tentativo di eseguire il rendering del report causerà un errore.
Se ParameterLanguage non viene specificato, la lingua specificata nell'intestazione Accepts-Language HTTP. Se non viene specificata alcuna lingua per l'intestazione Accepts-Language HTTP, viene utilizzata la lingua predefinita nel server di report.