Classe LocalReport
Représente un rapport traité et rendu localement sans connexion à un serveur de rapports.
Hiérarchie d'héritage
System.Object
Microsoft.Reporting.WinForms.Report
Microsoft.Reporting.WinForms.LocalReport
Espace de noms : Microsoft.Reporting.WinForms
Assembly : Microsoft.ReportViewer.WinForms (en Microsoft.ReportViewer.WinForms.dll)
Syntaxe
'Déclaration
<SerializableAttribute> _
Public NotInheritable Class LocalReport _
Inherits Report _
Implements ISerializable, IDisposable
'Utilisation
Dim instance As LocalReport
[SerializableAttribute]
public sealed class LocalReport : Report,
ISerializable, IDisposable
[SerializableAttribute]
public ref class LocalReport sealed : public Report,
ISerializable, IDisposable
[<SealedAttribute>]
[<SerializableAttribute>]
type LocalReport =
class
inherit Report
interface ISerializable
interface IDisposable
end
public final class LocalReport extends Report implements ISerializable, IDisposable
Le type LocalReport expose les membres suivants.
Constructeurs
| Nom | Description | |
|---|---|---|
.gif "Méthode publique") |
LocalReport | Initialise une nouvelle instance de la classe LocalReport. |
Haut de la page
Propriétés
| Nom | Description | |
|---|---|---|
.gif "Propriété publique") |
DataSources | Obtient une collection de sources de données utilisées par le rapport. |
|
DisplayName | Obtient ou définit le nom d'affichage du rapport. (hérité de Report.) |
|
EnableExternalImages | Indique si le rapport peut être rendu s'il contient des images externes. |
|
EnableHyperlinks | Indique si le rapport peut être rendu s'il contient des actions de lien hypertexte. |
|
IsDrillthroughReport | Indique si le rapport est un rapport d'extraction. (hérité de Report.) |
|
IsReadyForRendering | Obtient une valeur Boolean qui indique si une définition de rapport a été spécifiée, ainsi que tous les paramètres requis, et si toutes les sources de données sont prêtes à être utilisées. (hérité de Report.) |
|
OriginalParametersToDrillthrough | Retourne les paramètres transmis d'un rapport parent à ce rapport, s'il s'agit d'un rapport d'extraction. |
|
ReportEmbeddedResource | Obtient ou définit le nom de la ressource incorporée dans le rapport. |
|
ReportPath | Obtient ou définit le chemin d'accès au système de fichiers pour un rapport local. |
|
ShowDetailedSubreportMessages | Obtient ou définit une valeur boolean qui indique si des messages détaillés doivent s'afficher lorsqu'une erreur se produit dans un sous-rapport. |
Haut de la page
Méthodes
| Nom | Description | |
|---|---|---|
|
AddFullTrustModuleInSandboxAppDomain | Ajoute l'assembly fourni à la liste des assemblys qui s'exécutent en mode de confiance totale dans le domaine d'application sandbox. |
|
AddTrustedCodeModuleInCurrentAppDomain | Obsolète. Ajoute l'assembly fourni à la liste des assemblys dont l'exécution est approuvée dans l'objet AppDomain actuel. |
|
Dispose | Libère toutes les ressources utilisées par l'objet LocalReport. |
|
Equals | (hérité de Object.) |
|
ExecuteReportInCurrentAppDomain | Obsolète. Entraîne l'exécution des extensions et expressions de traitement du rapport dans l'objet AppDomain actuel. |
|
ExecuteReportInSandboxAppDomain | Obsolète. Entraîne l'exécution des extensions et expressions de traitement dans un domaine d'application avec des autorisations limitées. |
.gif "Méthode protégée") |
Finalize | (hérité de Object.) |
|
GetDataSourceNames | Retourne les noms de tous les datasets utilisées dans le rapport local. |
|
GetDefaultPageSettings | Obtient les paramètres de page par défaut spécifiés dans le rapport local. (remplace Report.GetDefaultPageSettings().) |
|
GetDocumentMap | Renvoie la représentation du plan du document pour le rapport local. (hérité de Report.) |
|
GetHashCode | (hérité de Object.) |
|
GetParameters | Renvoie les propriétés des paramètres du rapport. (remplace Report.GetParameters().) |
|
GetTotalPages() | Retourne le nombre total de pages conditionnelles dans le rapport. (hérité de Report.) |
|
GetTotalPages(PageCountMode%) | Retourne le nombre total de pages logiques du rapport, ainsi qu'une valeur d'énumération PageCountMode qui indique le mode actuel de dénombrement de pages. (remplace Report.GetTotalPages(PageCountMode%).) |
|
GetType | (hérité de Object.) |
|
ListRenderingExtensions | Renvoie toutes les extensions de rendu disponibles pour le rapport local. (remplace Report.ListRenderingExtensions().) |
|
LoadReportDefinition(TextReader) | Charge une définition de rapport à partir du système de fichiers local à l'aide d'une classe TextReader. (remplace Report.LoadReportDefinition(TextReader).) |
|
LoadReportDefinition(Stream) | Charge une définition de rapport pour le traitement à l'aide d'un Stream. (hérité de Report.) |
|
LoadSubreportDefinition(String, Stream) | Charge une définition de sous-rapport à l'aide d'un Stream. |
|
LoadSubreportDefinition(String, TextReader) | Charge une définition de sous-rapport à l'aide d'un TextReader. |
|
MemberwiseClone | (hérité de Object.) |
|
Refresh | Entraîne le rendu du rapport local avec de nouvelles données. (remplace Report.Refresh().) |
|
ReleaseSandboxAppDomain | Entraîne la libération immédiate par l'objet LocalReport de sa référence au domaine d'application sandbox. |
|
Render(String) | Traite le rapport et le rend au format spécifié. (hérité de Report.) |
|
Render(String, String) | Traite le rapport et le rend au format spécifié. (hérité de Report.) |
|
Render(String, String, CreateStreamCallback, array<Warning[]%) | Traite le rapport et le rend au format spécifié à l'aide d'un flux fourni par une fonction de rappel. |
|
Render(String, String, PageCountMode, CreateStreamCallback, array<Warning[]%) | Traite le rapport assorti d'un mode spécifique de dénombrement des pages et le rend au format spécifié à l'aide d'un flux fourni par une fonction de rappel. |
|
Render(String, String, String%, String%, String%, array<String[]%, array<Warning[]%) | Traite le rapport et le rend au format spécifié. (hérité de Report.) |
|
Render(String, String, PageCountMode, String%, String%, String%, array<String[]%, array<Warning[]%) | Traite le rapport selon un mode de dénombrement de pages spécifié et en effectue le rendu au format spécifié. (remplace Report.Render(String, String, PageCountMode, String%, String%, String%, array<String[]%, array<Warning[]%).) |
|
SetBasePermissionsForSandboxAppDomain | Définit les autorisations de base pour le domaine d'application sandbox avec le jeu d'autorisations fourni. |
|
SetParameters(IEnumerable<ReportParameter>) | Définit les propriétés des paramètres du rapport local. (remplace Report.SetParameters(IEnumerable<ReportParameter>).) |
|
SetParameters(ReportParameter) | Définit les propriétés des paramètres du rapport. (hérité de Report.) |
|
ToString | (hérité de Object.) |
Haut de la page
Événements
| Nom | Description | |
|---|---|---|
.gif "Événement public") |
SubreportProcessing | Se produit lors du traitement d'un sous-rapport. |
Haut de la page
Implémentations d'interfaces explicites
| Nom | Description | |
|---|---|---|
.gif "Implémentation d'interface explicite") .gif "Méthode privée") |
ISerializable.GetObjectData |
Haut de la page
Notes
La classe LocalReport représente les rapports traités et rendus localement sans connexion à un serveur de rapports. Cette classe correspond à l'objet utilisé par le contrôle ReportViewer, mais elle peut également être utilisée indépendamment comme objet non visuel qui encapsule les fonctionnalités de base du contrôle ReportViewer.
L'objet LocalReport peut ouvrir les fichiers de définition de rapport client (RDLC) à partir du système de fichiers ou depuis des ressources intégrées. Le fichier RDLC peut aussi lui être fourni en tant qu'objet Stream ou TextReader.
L'objet LocalReport ne peut pas exécuter de requêtes ni extraire des données. Au lieu de cela, les sources de données doivent être ajoutées à la propriété de la collection DataSources.
L'objet LocalReport prend en charge les paramètres de rapport, mais pas les invites de paramètres.
Exemples
Dans l'exemple de code suivant, un objet LocalReport est utilisé pour charger et exporter un rapport.
private void button1_Click(object sender, EventArgs e)
{
Microsoft.Reporting.WinForms.LocalReport lr = new Microsoft.Reporting.WinForms.LocalReport();
string deviceInfo =
"<DeviceInfo>" +
"<SimplePageHeaders>True</SimplePageHeaders>" +
"</DeviceInfo>";
lr.ReportPath = @"C:\My Reports\Monthly Sales.rdlc";
lr.DataSources.Add(new ReportDataSource("Sales", GetSalesData()));
byte[] bytes = lr.Render("Excel", deviceInfo, out mimeType,
out encoding, out streamids, out warnings);
using (FileStream fs = = new FileStream(@"c:\My Reports\Monthly Sales.xls", FileMode.Create))
{
fs.Write(bytes, 0, bytes.Length);
}
}
Private Sub Button1_Click(ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles Button1.Click
Dim warnings As Warning() = Nothing
Dim streamids As String() = Nothing
Dim mimeType As String = Nothing
Dim encoding As String = Nothing
Dim extension As String = Nothing
Dim deviceInfo as string
Dim bytes As Byte()
deviceInfo = "< deviceInfo ><SimplePageHeaders>True</SimplePageHeaders></DeviceInfo>"
bytes = ReportViewer1.LocalReport.Render("Excel", Nothing, _
mimeType,encoding, extension, streamids, warnings)
Dim fs As New FileStream("c:\output.xls", FileMode.Create)
fs.Write(bytes, 0, bytes.Length)
MessageBox.Show("Report exported to output.xls", "Info")
End Sub
Sécurité des threads
Tous les membres publics static (Shared dans Visual Basic) de ce type sont thread-safe. Tous les membres de l'instance ne sont pas garantis comme étant thread-safe.