Définition de la taille de la page et des sauts de page dans un rapport (Concepteur de rapports Visual Studio)

Vous pouvez contrôler la taille de la page et les sauts de page en spécifiant les propriétés de page dans la définition de rapport. Le type de contrôle utilisé et le format d'exportation servant à visualiser un rapport peuvent affecter la pagination. Le mode de visualisation d'un rapport détermine sa pagination. La liste suivante décrit brièvement le mode de pagination pour différents scénarios :

• Le contrôle Windows Forms présente par défaut un rapport dans le format GDI (Graphical Device Instrumentation). Ce format de sortie utilise des sauts de page conditionnels (ou sauts de page logiques) qui sont calculés au moment de l'exécution.

• Le contrôle de serveur Web présente un rapport dans le format HTML, qui utilise des sauts de page conditionnels (ou sauts de page logiques) calculés au moment de l'exécution. Les pages HTML sont calculées à partir du nombre de lignes et de colonnes renvoyées pour le rapport.

• Le format de sortie Excel utilise des sauts de page conditionnels (ou sauts de page logiques) qui sont calculés au moment de l'exécution. Les pages Excel sont calculées en tant que feuilles de calcul d'un même classeur. Si un classeur contient quatre feuilles de calcul, chaque feuille est considérée comme une page unique.

• Les extensions de rendu PDF et Image sont des formats orientés page. Par conséquent, vous pouvez définir des propriétés pour contrôler avec précision les sauts de page des rapports visualisés dans les formats PDF ou Image (TIFF).

Les formats de sortie HTML et Excel ne gèrent pas les pages physiques. En outre, les rapports HTML peuvent être interactifs ; cela signifie que les actions réalisées par l'utilisateur dans un rapport peuvent déclencher un traitement supplémentaire qui provoque l'extension du rapport horizontalement ou verticalement afin qu'il puisse accueillir du contenu additionnel. Vous ne pouvez pas contrôler avec précision la pagination des rapports visualisés dans ce format s'ils contiennent des fonctionnalités interactives.

Utilisation de sauts de page pour améliorer les performances du traitement des rapports

Vous pouvez utiliser des sauts de page pour améliorer les performances des rapports volumineux pendant les opérations de rendu et de visualisation. Selon la façon dont le rapport est visualisé et selon que le contrôle est configuré ou non pour un traitement asynchrone, le contrôle affiche la page du rapport dans la visionneuse tandis que les autres pages sont restituées en arrière-plan. Cela permet à un utilisateur de commencer à visualiser les pages initiales du rapport en attendant que d'autres pages soient disponibles.

La sortie HTML et Excel affiche un rapport sur une seule page s'il n'y a pas de saut de page. Si vous définissez les propriétés InteractiveHeight et InteractiveWidth, les rapports restitués par les formats de sortie HTML et Excel comportent des sauts de page conditionnels. Les sauts de page conditionnels sont placés sur une page à partir d'une taille de page estimée, ce qui rend la taille des rapports moins exacte que celle des rapports générés par un format de sortie qui prend en charge la taille de page. Les sauts de page conditionnels sont calculés au moment de l'exécution par le contrôle. Bien que cela ne soit pas recommandé, vous pouvez désactiver les sauts de page conditionnels en attribuant la valeur 0 à la propriété InteractiveHeight.

Spécification des sauts de page et des tailles de page

Les sauts de page déterminent l'adaptation du contenu à une page de rapport. Vous pouvez définir des sauts de page avant ou après des éléments de rapport à l'aide des propriétés de ces éléments.

Vous pouvez ajouter des sauts de page au début ou à la fin d'un rectangle, d'une table, d'une matrice, d'une liste, d'un graphique ou d'un groupe. Par défaut, les éléments de rapport ne comprennent pas de saut de page. Pour ajouter un saut de page au début ou à la fin d'un élément, modifiez la propriété PageBreakAtEnd ou PageBreakAtStart de ce dernier.

En outre, les sauts de page se produisent automatiquement pour les extensions de rendu orientées page, telles que PDF et Image, qui appliquent une taille de page uniforme à l'ensemble du rapport. Les propriétés suivantes permettent de spécifier des sauts de page basés sur la taille de page :

• Les propriétés PageHeight et PageWidth sont utilisées par les extensions de rendu PDF et Image pour définir l'apparition régulière de sauts de page en fonction d'une mesure physique.

• Les propriétés InteractiveHeight et InteractiveWidth sont équivalentes aux propriétés PageHeight et PageWidth, mais concernent l'extension de rendu HTML. Étant donné que le format de sortie HTML redimensionne dynamiquement un rapport pour pouvoir prendre en charge les fonctionnalités d'exploration, d'extraction, d'affichage et de masquage, le serveur de rapports utilise différentes propriétés pour gérer la pagination des pages dynamiques.

Remarque

La largeur d'un rapport peut être supérieure à la largeur de la page. Si un rapport plus large que le format de papier spécifié est généré à l'aide d'une extension de rendu prenant en charge les formats de papier, le rapport résultant peut s'étaler horizontalement sur plusieurs pages. Si vous avez conçu un rapport de sorte qu'il soit affiché sur une seule page alors que son rendu occupe plusieurs pages, vérifiez si sa largeur n'est pas supérieure à celle du format de papier.

Pour plus d'informations sur la définition de la taille de la page et des sauts de page, consultez Procédure : définir des sauts de page (Concepteur de rapports Visual Studio).

Voir aussi

Concepts

Configuration de ReportViewer pour un rendu asynchrone
Ajout d'en-têtes et de pieds de page à un rapport (Concepteur de rapports Visual Studio)