LocalReport, classe

Représente un rapport traité et rendu localement sans connexion à un serveur de rapports.

Hiérarchie d'héritage

Object
  Microsoft.Reporting.WebForms.Report
    Microsoft.Reporting.WebForms.LocalReport

Espace de noms :  Microsoft.Reporting.WebForms
Assembly :  Microsoft.ReportViewer.WebForms (dans Microsoft.ReportViewer.WebForms.dll)

Syntaxe

'Déclaration
<SerializableAttribute> _
Public NotInheritable Class LocalReport _
    Inherits Report _
    Implements ISerializable, IDisposable

[SerializableAttribute]
public sealed class LocalReport : Report, 
    ISerializable, IDisposable

[SerializableAttribute]
public ref class LocalReport sealed : public Report, 
    ISerializable, IDisposable

[<Sealed>]
[<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
	LocalReport	Initialise une nouvelle instance de la classe LocalReport.

Début

Propriétés

	Nom	Description
	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, et si toutes les sources de données sont prêtes à être utilisées. (Hérité de Report.)
	MapTileServerConfiguration	Définit des paramètres de configuration pour les services Microsoft Bing Maps SOAP qui fournissent un arrière-plan de mosaïques pour les éléments de rapport cartographique dans le rapport.
	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 local pour un rapport local.
	ShowDetailedSubreportMessages	Obtient ou définit une valeur Boolean qui indique si des messages détaillés doivent être affichés quand une erreur se produit dans un sous-rapport.

Début

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 d'assemblys de confiance pouvant s'exécuter dans le AppDomain actuel.
	Dispose	Libère toutes les ressources qui sont utilisées par l'objet LocalReport.
	Equals	Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
	ExecuteReportInCurrentAppDomain	Obsolète. Entraîne l'exécution, dans le AppDomain actuel, des extensions et des expressions de traitement présentes dans le rapport.
	ExecuteReportInSandboxAppDomain	Obsolète. Entraîne l'exécution des extensions et des expressions de traitement avec des autorisations limitées dans un domaine d'application.
	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. (Substitue Report.GetDefaultPageSettings().)
	GetDocumentMap	Renvoie la représentation du plan du document pour le rapport local. (Hérité de Report.)
	GetHashCode	Sert de fonction de hachage par défaut. (Hérité de Object.)
	GetParameters	Retourne les propriétés des paramètres du rapport. (Substitue 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 conditionnelles dans le rapport et une valeur d'énumération PageCountMode qui indique le mode de décompte de pages actuel. (Substitue Report.GetTotalPages(PageCountMode%).)
	GetType	Obtient le Type de l'instance actuelle. (Hérité de Object.)
	ListRenderingExtensions	Renvoie toutes les extensions de rendu disponibles pour le rapport local. (Substitue Report.ListRenderingExtensions().)
	LoadReportDefinition(TextReader)	Charge une définition de rapport à partir du système de fichiers local en utilisant un TextReader. (Substitue 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 en utilisant un Stream.
	LoadSubreportDefinition(String, TextReader)	Charge une définition de sous-rapport en utilisant un TextReader.
	Refresh	Entraîne le rendu du rapport local avec de nouvelles données. (Substitue Report.Refresh().)
	ReleaseSandboxAppDomain	Oblige l'objet LocalReport à libérer immédiatement sa référence au domaine d'applications bac à sable (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é. (Substitue 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. (Substitue Report.SetParameters(IEnumerable<ReportParameter>).)
	SetParameters(ReportParameter)	Définit les propriétés des paramètres du rapport. (Hérité de Report.)
	ToString	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)

Début

Événements

	Nom	Description
	SubreportProcessing	Se produit lors du traitement d'un sous-rapport.

Début

Implémentations d'interface explicite

	Nom	Description
	ISerializable.GetObjectData

Début

Notes

The LocalReport class represents reports that are processed and rendered locally without connecting to a report server. This class is the same object that is used by the ReportViewer control, but it also can be used independently as a non-visual object that encapsulates the core functionality of the ReportViewer control.

The LocalReport object can open client report definition (RDLC) files from the file system or from embedded resources, or the RDLC file can be supplied to it as a Stream or a TextReader.

The LocalReport object does not have the ability to execute queries or fetch data; instead data sources must be added to the DataSources collection property.

The LocalReport object supports report parameters, but does not support parameter prompts

Exemples

In the following code example, a LocalReport object is used to load and export a report.

protected void Button1_Click(object sender, EventArgs e)
{

   Microsoft.Reporting.WebForms.LocalReport lr = 
     new Microsoft.Reporting.WebForms.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);
      }
}

Protected Sub Button1_Click(ByVal sender As 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()

   Dim lr As New Microsoft.Reporting.WebForms.LocalReport

   lr.ReportPath = "C:\My Reports\Monthly Sales.rdlc"

   lr.DataSources.Add(New ReportDataSource("Sales", GetSalesData()))

   deviceInfo = _
"<DeviceInfo><SimplePageHeaders>True</SimplePageHeaders></DeviceInfo>"

   bytes = ReportViewer1.LocalReport.Render("Excel", deviceInfo,_
      mimeType, encoding, extension, streamids, warnings)

   Dim fs As New FileStream("c:\output.xls", FileMode.Create)
   fs.Write(bytes, 0, bytes.Length)

End Sub

Sécurité des threads

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Voir aussi

Référence

Microsoft.Reporting.WebForms, espace de noms