LocalReport-Klasse

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

Vererbungshierarchie

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

Namespace:  Microsoft.Reporting.WebForms
Assembly:  Microsoft.ReportViewer.WebForms (in Microsoft.ReportViewer.WebForms.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
	LocalReport	Initialisiert eine neue Instanz der LocalReport-Klasse.

Zum Anfang

Eigenschaften

	Name	Beschreibung
	DataSources	Ruft eine Auflistung der vom Bericht verwendeten Datenquellen ab.
	DisplayName	Ruft den angezeigten Namen des Berichts ab bzw. legt diesen fest. (Geerbt von Report.)
	EnableExternalImages	Gibt an, ob der Bericht gerendert werden kann, wenn er externe Bilder enthält.
	EnableHyperlinks	Gibt an, ob der Bericht gerendert werden kann, wenn er Linkaktionen enthält.
	IsDrillthroughReport	Gibt an, ob es sich bei dem Bericht um einen Drillthroughbericht handelt. (Geerbt von Report.)
	IsReadyForRendering	Ruft einen Boolean-Wert ab, der angibt, ob eine Berichtsdefinition und alle Parameter angegeben wurden und alle Datenquellen bereit zur Verwendung sind. (Geerbt von Report.)
	OriginalParametersToDrillthrough	Gibt die Parameter zurück, die von einem übergeordneten Bericht an diesen Bericht übergeben werden, sofern es sich um einen Drillthroughbericht handelt.
	ReportEmbeddedResource	Ruft den Namen der eingebetteten Ressource des Berichts ab bzw. legt diesen fest.
	ReportPath	Ruft den lokalen Dateisystempfad des lokalen Berichts ab bzw. legt diesen fest.
	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
	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.
	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.
	Dispose	Gibt alle Ressourcen frei, die vom LocalReport-Objekt verwendet werden.
	Equals	(Geerbt von Object.)
	ExecuteReportInCurrentAppDomain	Veraltet Bewirkt, dass Verarbeitungserweiterungen und -ausdrücke des Berichts im aktuellen AppDomain-Objekt ausgeführt werden.
	ExecuteReportInSandboxAppDomain	Veraltet Bewirkt, dass Verarbeitungserweiterungen und -ausdrücke mit begrenzten Berechtigungen in einer Anwendungsdomäne ausgeführt werden.
	Finalize	(Geerbt von Object.)
	GetDataSourceNames	Gibt die Namen aller innerhalb des lokalen Berichts verwendeten Datasets zurück.
	GetDefaultPageSettings	Ruft die standardmäßigen Seiteneinstellungen ab, die im lokalen Bericht angegeben sind. (Überschreibt Report.GetDefaultPageSettings().)
	GetDocumentMap	Gibt die Darstellung der Dokumentstruktur für den lokalen Bericht zurück. (Geerbt von Report.)
	GetHashCode	(Geerbt von Object.)
	GetParameters	Gibt Berichtsparametereigenschaften für den Bericht zurück. (Überschreibt Report.GetParameters().)
	GetTotalPages()	Gibt die Gesamtzahl der Softwareseiten im Bericht zurück. (Geerbt von Report.)
	GetTotalPages(PageCountMode%)	Gibt die Gesamtzahl der Softwareseiten im Bericht und einen PageCountMode-Enumerationswert zurück, der den aktuellen Seitenanzahlmodus angibt. (Überschreibt Report.GetTotalPages(PageCountMode%).)
	GetType	(Geerbt von Object.)
	ListRenderingExtensions	Gibt alle verfügbaren Renderingerweiterungen für den lokalen Bericht zurück. (Überschreibt Report.ListRenderingExtensions().)
	LoadReportDefinition(TextReader)	Lädt mithilfe eines TextReader-Objekts eine Berichtsdefinition aus dem lokalen Dateisystem. (Überschreibt Report.LoadReportDefinition(TextReader).)
	LoadReportDefinition(Stream)	Lädt eine Berichtsdefinition für die Verarbeitung per Stream. (Geerbt von Report.)
	LoadSubreportDefinition(String, Stream)	Lädt eine Unterberichtsdefinition mithilfe eines Stream-Objekts.
	LoadSubreportDefinition(String, TextReader)	Lädt eine Unterberichtsdefinition mithilfe eines TextReader-Objekts.
	MemberwiseClone	(Geerbt von Object.)
	Refresh	Bewirkt, dass der lokale Bericht mit neuen Daten gerendert wird. (Überschreibt Report.Refresh().)
	ReleaseSandboxAppDomain	Bewirkt, dass das LocalReport-Objekt seinen Verweis auf die Sandbox-Anwendungsdomäne sofort freigibt.
	Render(String)	Verarbeitet den Bericht und rendert ihn im angegebenen Format. (Geerbt von Report.)
	Render(String, String)	Verarbeitet den Bericht und rendert ihn im angegebenen Format. (Geerbt von Report.)
	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.
	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.
	Render(String, String, String%, String%, String%, array<String[]%, array<Warning[]%)	Verarbeitet den Bericht und rendert ihn im angegebenen Format. (Geerbt von Report.)
	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[]%).)
	SetBasePermissionsForSandboxAppDomain	Legt die Basisberechtigungen für die Sandbox-Anwendungsdomäne mit dem angegebenen Berechtigungssatz fest.
	SetParameters(IEnumerable<ReportParameter>)	Legt Berichtsparametereigenschaften für den lokalen Bericht fest. (Überschreibt Report.SetParameters(IEnumerable<ReportParameter>).)
	SetParameters(ReportParameter)	Legt die Berichtsparametereigenschaften für den Bericht fest. (Geerbt von Report.)
	ToString	(Geerbt von Object.)

Zum Anfang

Ereignisse

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

Zum Anfang

Explizite Schnittstellenimplementierungen

	Name	Beschreibung
	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. Es kann jedoch 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.

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

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.WebForms-Namespace