ReportExecutionService.Render2 Méthode

Définition

Espace de noms:: ReportExecution2005

Assembly:: ReportExecution2005.dll

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 l’affiche dans le 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

Le format dans lequel il faut afficher le rapport. Cet argument correspond à une extension de rendu. Les extensions prises en charge incluent XML, NULL, CSV, IMAGE, PDF, HTML4.0, HTML3.2, MHTML, Excel et Word. Une liste d’extensions prises en charge peut être obtenue en appelant la ListRenderingExtensions() méthode.

DeviceInfo: String

Une chaîne XML contenant 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 comme éléments internes d’un élément XML DeviceInfo. Pour plus d’informations sur les paramètres d’information des appareils pour certains formats de sortie, voir Passer les paramètres d’information des périphériques aux extensions de rendu.

PaginationMode: PageCountMode

Le mode de traitement du rapport.

Extension: String

[dehors] L’extension de fichier correspondant au flux de sortie.

MimeType: String

[dehors] Le type MIME du rapport rendu.

Encoding: String

[dehors] L’encodage utilisé lors du serveur de rapports affiche le contenu du rapport.

Warnings: Warning[]

[dehors] Un tableau d’objets Warning qui décrit les avertissements survenus lors du traitement du rapport.

StreamIds: String[]

[dehors] Les identifiants de ruisseau. Ces identifiants sont transmis à la RenderStream(String, String, String, String, String) méthode. Vous pouvez les utiliser pour afficher les ressources externes (images, etc.) associées à un rapport donné.

Retours

Byte[]

Un tableau Byte[] du rapport dans le format spécifié.

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>

Render2 affiche un rapport traité associé à l’exécution du rapport identifiée dans l’en-tête ExecutionInfo2 . Si aucun instantané de session n’existe, cette méthode exécutera le rapport (si toutes les exigences en termes d’identifiants et de paramètres sont remplies), ce qui entraînera la création d’un nouvel instantané de session. Si le rapport doit être retraité parce que les valeurs non liées aux paramètres de requête ont changé, l’instantané sera retraité.

Si les options d’exécution sont définies en cache ou en snapshot d’exécution, l’appel peut Render2 utiliser un snapshot existant.

Si le rapport est mis en cache et que les valeurs de paramètres et identifiants fournis correspondent, la copie mise en cache de l’instantané peut être chargée au lieu de traiter réellement le rapport.

Si les exigences de crédentiel et de paramètres ne sont pas remplies, cette méthode renverra une erreur.

Les appels suivants Render2 peuvent être utilisés pour récupérer des pages supplémentaires du rapport si l’extension de rendu permet de spécifier plusieurs pages.

Une limitation de la méthode Render est que la sortie ne peut pas être diffusée en streaming, donc tout le fichier doit être en mémoire.

Veuillez consulter Identifier l’état d’exécution pour une discussion sur le cycle de vie d’exécution, qui inclut une description des étapes nécessaires pour charger et afficher un rapport.

S’applique à