ReportExecutionService.Render2 Méthode

Définition

Espace de noms:

ReportExecution2005

Assembly:

ReportExecution2005.dll

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

Byte[]

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.