Freigeben über


LocalReport-Klasse

Stellt einen Bericht dar, der lokal verarbeitet und gerendert wird, ohne eine Verbindung mit einem Berichtsserver herzustellen.

Vererbungshierarchie

System.Object
  Microsoft.Reporting.WinForms.Report
    Microsoft.Reporting.WinForms.LocalReport

Namespace:  Microsoft.Reporting.WinForms
Assembly:  Microsoft.ReportViewer.WinForms (in Microsoft.ReportViewer.WinForms.dll)

Syntax

'Declaration
<SerializableAttribute> _
Public NotInheritable Class LocalReport _
    Inherits Report _
    Implements ISerializable, IDisposable
'Usage
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

Der LocalReport-Typ macht folgende Elemente verfügbar.

Konstruktoren

  Name Beschreibung
Öffentliche Methode LocalReport Initialisiert eine neue Instanz der LocalReport-Klasse.

Zum Anfang

Eigenschaften

  Name Beschreibung
Öffentliche Eigenschaft DataSources Ruft eine Auflistung der vom Bericht verwendeten Datenquellen ab.
Öffentliche Eigenschaft DisplayName Ruft den angezeigten Namen des Berichts ab bzw. legt diesen fest. (Geerbt von Report.)
Öffentliche Eigenschaft EnableExternalImages Gibt an, ob der Bericht gerendert werden kann, wenn er externe Bilder enthält.
Öffentliche Eigenschaft EnableHyperlinks Gibt an, ob der Bericht gerendert werden kann, wenn er Linkaktionen enthält.
Öffentliche Eigenschaft IsDrillthroughReport Gibt an, ob es sich bei dem Bericht um einen Drillthroughbericht handelt. (Geerbt von Report.)
Öffentliche Eigenschaft IsReadyForRendering Ruft einen Boolean-Wert ab, der angibt, ob eine Berichtsdefinition und alle erforderlichen Parameter angegeben wurden und alle Datenquellen bereit zur Verwendung sind. (Geerbt von Report.)
Öffentliche Eigenschaft OriginalParametersToDrillthrough Gibt die Parameter zurück, die von einem übergeordneten Bericht an diesen Bericht übergeben werden, sofern es sich um einen Drillthroughbericht handelt.
Öffentliche Eigenschaft ReportEmbeddedResource Ruft den Namen der eingebetteten Ressource des Berichts ab bzw. legt diesen fest.
Öffentliche Eigenschaft ReportPath Ruft den Dateisystempfad des lokalen Berichts ab bzw. legt diesen fest.
Öffentliche Eigenschaft ShowDetailedSubreportMessages Ruft einen Boolean-Wert ab (bzw. legt diesen fest), der angibt, ob ausführliche Meldungen angezeigt werden sollen, wenn in einem Unterbericht ein Fehler auftritt.

Zum Anfang

Methoden

  Name Beschreibung
Öffentliche Methode AddFullTrustModuleInSandboxAppDomain Fügt der Liste der Assemblys, die in der Sandbox-Anwendungsdomäne im Modus "Voll vertrauenswürdig" ausgeführt werden, die angegebene Assembly hinzu.
Öffentliche Methode AddTrustedCodeModuleInCurrentAppDomain Veraltet Fügt die bereitgestellte Assembly der Liste der Assemblys hinzu, die als vertrauenswürdig gelten und im aktuellen AppDomain-Objekt ausgeführt werden können.
Öffentliche Methode Dispose Gibt alle Ressourcen frei, die vom LocalReport-Objekt verwendet werden.
Öffentliche Methode Equals (Geerbt von Object.)
Öffentliche Methode ExecuteReportInCurrentAppDomain Veraltet Bewirkt, dass Verarbeitungserweiterungen und -ausdrücke des Berichts im aktuellen AppDomain-Objekt ausgeführt werden.
Öffentliche Methode ExecuteReportInSandboxAppDomain Veraltet Bewirkt, dass Verarbeitungserweiterungen und -ausdrücke in einer Anwendungsdomäne mit begrenzten Berechtigungen ausgeführt werden.
Geschützte Methode Finalize (Geerbt von Object.)
Öffentliche Methode GetDataSourceNames Gibt die Namen aller innerhalb des lokalen Berichts verwendeten Datasets zurück.
Öffentliche Methode GetDefaultPageSettings Ruft die standardmäßigen Seiteneinstellungen ab, die im lokalen Bericht angegeben sind. (Überschreibt Report.GetDefaultPageSettings().)
Öffentliche Methode GetDocumentMap Gibt die Darstellung der Dokumentstruktur für den lokalen Bericht zurück. (Geerbt von Report.)
Öffentliche Methode GetHashCode (Geerbt von Object.)
Öffentliche Methode GetParameters Gibt Berichtsparametereigenschaften für den Bericht zurück. (Überschreibt Report.GetParameters().)
Öffentliche Methode GetTotalPages() Gibt die Gesamtzahl der Softwareseiten im Bericht zurück. (Geerbt von Report.)
Öffentliche Methode GetTotalPages(PageCountMode%) Gibt die Gesamtzahl der Softwareseiten im Bericht und einen PageCountMode-Enumerationswert zurück, der den aktuellen Seitenanzahlmodus angibt. (Überschreibt Report.GetTotalPages(PageCountMode%).)
Öffentliche Methode GetType (Geerbt von Object.)
Öffentliche Methode ListRenderingExtensions Gibt alle verfügbaren Renderingerweiterungen für den lokalen Bericht zurück. (Überschreibt Report.ListRenderingExtensions().)
Öffentliche Methode LoadReportDefinition(TextReader) Lädt mithilfe eines TextReader-Objekts eine Berichtsdefinition aus dem lokalen Dateisystem. (Überschreibt Report.LoadReportDefinition(TextReader).)
Öffentliche Methode LoadReportDefinition(Stream) Lädt eine Berichtsdefinition für die Verarbeitung per Stream. (Geerbt von Report.)
Öffentliche Methode LoadSubreportDefinition(String, Stream) Lädt eine Unterberichtsdefinition mithilfe eines Stream-Objekts.
Öffentliche Methode LoadSubreportDefinition(String, TextReader) Lädt eine Unterberichtsdefinition mithilfe eines TextReader-Objekts.
Geschützte Methode MemberwiseClone (Geerbt von Object.)
Öffentliche Methode Refresh Bewirkt, dass der lokale Bericht mit neuen Daten gerendert wird. (Überschreibt Report.Refresh().)
Öffentliche Methode ReleaseSandboxAppDomain Bewirkt, dass das LocalReport-Objekt seinen Verweis auf die Sandbox-Anwendungsdomäne sofort freigibt.
Öffentliche Methode Render(String) Verarbeitet den Bericht und rendert ihn im angegebenen Format. (Geerbt von Report.)
Öffentliche Methode Render(String, String) Verarbeitet den Bericht und rendert ihn im angegebenen Format. (Geerbt von Report.)
Öffentliche Methode Render(String, String, CreateStreamCallback, array<Warning[]%) Verarbeitet den Bericht und rendert ihn im angegebenen Format mithilfe eines Datenstroms, der von einer Rückruffunktion bereitgestellt wird.
Öffentliche Methode Render(String, String, PageCountMode, CreateStreamCallback, array<Warning[]%) Verarbeitet den Bericht mit einem angegebenen Seitenanzahlmodus und rendert ihn im angegebenen Format mithilfe eines Datenstroms, der von einer Rückruffunktion bereitgestellt wird.
Öffentliche Methode Render(String, String, String%, String%, String%, array<String[]%, array<Warning[]%) Verarbeitet den Bericht und rendert ihn im angegebenen Format. (Geerbt von Report.)
Öffentliche Methode Render(String, String, PageCountMode, String%, String%, String%, array<String[]%, array<Warning[]%) Verarbeitet den Bericht mit einem angegebenen Seitenanzahlmodus und rendert ihn im angegebenen Format. (Überschreibt Report.Render(String, String, PageCountMode, String%, String%, String%, array<String[]%, array<Warning[]%).)
Öffentliche Methode SetBasePermissionsForSandboxAppDomain Legt die Basisberechtigungen für die Sandbox-Anwendungsdomäne mit dem angegebenen Berechtigungssatz fest.
Öffentliche Methode SetParameters(IEnumerable<ReportParameter>) Legt Berichtsparametereigenschaften für den lokalen Bericht fest. (Überschreibt Report.SetParameters(IEnumerable<ReportParameter>).)
Öffentliche Methode SetParameters(ReportParameter) Legt die Berichtsparametereigenschaften für den Bericht fest. (Geerbt von Report.)
Öffentliche Methode ToString (Geerbt von Object.)

Zum Anfang

Ereignisse

  Name Beschreibung
Öffentliches Ereignis SubreportProcessing Tritt auf, wenn ein Unterbericht verarbeitet wird.

Zum Anfang

Explizite Schnittstellenimplementierungen

  Name Beschreibung
Explizite SchnittstellenimplementierungPrivate Methode ISerializable.GetObjectData

Zum Anfang

Hinweise

Die LocalReport-Klasse stellt Berichte dar, die lokal verarbeitet und gerendert werden, ohne eine Verbindung mit einem Berichtsserver herzustellen. Bei dieser Klasse handelt es sich um das gleiche Objekt, das vom ReportViewer-Steuerelement verwendet wird, doch kann es auch als unabhängiges, nicht visuelles Objekt verwendet werden, das die Kernfunktionen des ReportViewer-Steuerelements kapselt.

Das LocalReport-Objekt kann Client-Berichtsdefinitionsdateien (RDLC-Dateien) aus dem Dateisystem oder aus eingebetteten Ressourcen öffnen, oder die RDLC-Datei kann für das Objekt als Stream oder TextReader bereitgestellt werden.

Das LocalReport-Objekt ist nicht mit der Funktionalität zum Ausführen von Abfragen oder Abrufen von Daten ausgestattet. Stattdessen müssen der DataSources-Auflistungseigenschaft Datenquellen hinzugefügt werden.

Das LocalReport-Objekt unterstützt Berichtsparameter, es unterstützt jedoch keine Parametereingabeaufforderungen.

Beispiele

Im folgenden Codebeispiel wird ein Bericht mithilfe eines LocalReport-Objekts geladen und exportiert.

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

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Elemente dieses Typs sind Threadsicher. Für Instanzelemente wird die Threadsicherheit nicht gewährleistet.

Siehe auch

Verweis

Microsoft.Reporting.WinForms-Namespace