ReportExecutionService.SetExecutionParameters Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Définit et valide les valeurs des paramètres associées à l’exécution du rapport en cours.
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
Paramètres
- Parameters
- ParameterValue[]
Tableau d'objets ParameterValue.
- ParameterLanguage
- String
Un identifiant de localisation du cadre .NET.
Retours
Un ExecutionInfo objet contenant la nouvelle exécution.
Remarques
Le tableau ci-dessous présente les informations sur l’en-tête et les autorisations concernant cette opération.
| Utilisation de l’en-tête SOAP | (En) TrustedUserHeaderValue (En) ExecutionHeaderValue (Dehors) ServerInfoHeaderValue |
| Mode natif : autorisations requises | Sur le rapport principal et tous les sous-rapports : ReadProperties ET ExecuteAndView |
| Permissions requises en mode SharePoint | Sur le rapport principal et tous les sous-rapports : <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems> |
Si un instantané existe dans l’exécution actuelle lorsque les valeurs de paramètre sont définies, il sera effacé s’il ne s’agit pas d’une exécution ou d’un instantané historique, ce qui nécessitera que le rapport soit à nouveau exécuté. Pour les instantanés d’exécution ou d’historique, vous pouvez spécifier des valeurs pour des paramètres non liés à la requête. Notez que le serveur de rapports n’effectue pas le traitement des données pour les instantanés d’exécution ou d’historique.
Si la valeur du paramètre que vous spécifiez a un type incorrect, la méthode retournera une erreur et le paramètre ne sera pas modifié. Si la valeur du paramètre a le type correct, mais n’est pas une valeur valide, le paramètre entre dans l’état MissingValidValue . Dans les deux cas, tenter de rendre le rapport entraînera une erreur.
Si ParameterLanguage n’est pas spécifié, le langage est spécifié dans l’en-tête Accepts-Language HTTP. Si aucun langage n’est spécifié pour l’en-tête Accepts-Language HTTP, le langage par défaut sur le serveur de rapports est utilisé.