ReportExecutionService.Render2 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.
Traite un rapport spécifique et effectue le rendu du rapport au format spécifié.
public:
cli::array <System::Byte> ^ Render2(System::String ^ Format, System::String ^ DeviceInfo, ReportExecution2005::PageCountMode PaginationMode, [Runtime::InteropServices::Out] System::String ^ % Extension, [Runtime::InteropServices::Out] System::String ^ % MimeType, [Runtime::InteropServices::Out] System::String ^ % Encoding, [Runtime::InteropServices::Out] cli::array <ReportExecution2005::Warning ^> ^ % Warnings, [Runtime::InteropServices::Out] cli::array <System::String ^> ^ % StreamIds);public byte[] Render2 (string Format, string DeviceInfo, ReportExecution2005.PageCountMode PaginationMode, out string Extension, out string MimeType, out string Encoding, out ReportExecution2005.Warning[] Warnings, out string[] StreamIds);member this.Render2 : string * string * ReportExecution2005.PageCountMode * string * string * string * Warning[] * String[] -> byte[]Public Function Render2 (Format As String, DeviceInfo As String, PaginationMode As PageCountMode, ByRef Extension As String, ByRef MimeType As String, ByRef Encoding As String, ByRef Warnings As Warning(), ByRef StreamIds As String()) As Byte()Paramètres
- Format
- String
Format de rendu du rapport. Cet argument correspond à une extension de rendu Les extensions de rendu prises en charge sont XML, NULL, CSV, IMAGE, PDF, HTML4.0, HTML3.2, MHTML, EXCEL et Word. Une liste des extensions prises en charge peut être obtenue en appelant la méthode ListRenderingExtensions().
- DeviceInfo
- String
Chaîne XML qui contient le contenu spécifique à l’appareil requis par l’extension de rendu spécifiée dans le Format paramètre. Les paramètres DeviceInfo doivent être passés en tant qu'éléments internes d'un élément XML DeviceInfo. Pour plus d’informations sur les paramètres d’informations sur l’appareil pour des formats de sortie spécifiques, consultez Passer des paramètres d’informations sur l’appareil aux extensions de rendu.
- PaginationMode
- PageCountMode
Mode de traitement du rapport.
- Extension
- String
[out] Extension de fichier correspondant au flux de sortie.
- MimeType
- String
[out] Type MIME du rapport rendu.
- Encoding
- String
[out] Encodage utilisé lorsque le serveur de rapports restitue le contenu du rapport.
- Warnings
- Warning[]
[out] Tableau d'objets Warning qui décrit les avertissements qui ont été rencontrés pendant le traitement du rapport.
- StreamIds
- String[]
[out] Identificateurs de flux. Ces ID sont passés à la méthode RenderStream(String, String, String, String, String). Vous pouvez les utiliser pour restituer les ressources externes (images, etc.) qui sont associées à un rapport donné.
Retours
Tableau Byte[] du rapport au format spécifié.
Remarques
Le tableau suivant présente les informations relatives aux en-têtes et aux autorisations sur cette opération.
| Utilisation de l’en-tête SOAP | (In) TrustedUserHeaderValue (In) ExecutionHeaderValue (Out) ServerInfoHeaderValue |
| Autorisations requises en mode natif | Sur le main rapport et tous les sous-rapports : ReadProperties ANDExecuteAndView |
| Mode SharePoint Autorisations requises | Sur le main rapport et tous les sous-rapports :<xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems> |
Render2 rend un rapport traité associé à l’exécution du rapport identifié dans l’en-tête ExecutionInfo2 . S’il n’existe aucune session instantané, cette méthode exécute le rapport (si toutes les exigences en matière d’informations d’identification et de paramètres sont remplies), ce qui entraîne la création d’une nouvelle session instantané. Si le rapport doit être retraité parce que les valeurs de paramètres autres que la requête ont changé, la instantané est retraitée.
Si les options d’exécution sont définies pour mettre en cache ou instantané d’exécution, l’appel à Render2 peut utiliser une instantané existante.
Si le rapport est défini sur la mise en cache et que les valeurs de paramètre et les informations d’identification fournies correspondent, la copie mise en cache du instantané peut être chargée au lieu de traiter le rapport.
Si les exigences en matière d’informations d’identification et de paramètres ne sont pas remplies, cette méthode retourne une erreur.
Les appels suivants à Render2 peuvent être utilisés pour extraire des pages supplémentaires du rapport si l’extension de rendu prend en charge la spécification de plusieurs pages.
Une limitation de la méthode Render est que la sortie ne peut pas être diffusée en continu, de sorte que le fichier entier doit être en mémoire.
Pour plus d’informations sur le cycle de vie de l’exécution, consultez Identification de l’état d’exécution, qui comprend une description des étapes nécessaires pour charger et restituer un rapport.