LocalReport-Klasse

Repräsentiert einen Bericht, der lokal verarbeitet und wiedergegeben wird, ohne sich mit einem Berichtserver zu verbinden.

Vererbungshierarchie

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

[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

Der LocalReport-Typ macht die folgenden Member verfügbar.

Konstruktoren

	Name	Beschreibung
	LocalReport	Initialisiert eine neue Instanz derLocalReport-Klasse.

Zum Seitenanfang

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. (Von Report geerbt.)
	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. (Von Report geerbt.)
	IsReadyForRendering	Ruft einen Boolean-Wert ab, der angibt, ob eine Berichtsdefinition und alle erforderlichen Parameter angegeben wurden und alle Datenquellen bereit zur Verwendung sind. (Von Report geerbt.)
	MapTileServerConfiguration	Definiert Konfigurationseinstellungen für Microsoft Bing Maps SOAP Services, die einen Kachelhintergrund für Kartenberichtselemente im Bericht bereitstellen.
	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 Dateisystempfad des lokalen Berichts ab bzw. legt diesen fest.
	ShowDetailedSubreportMessages	Ruft einen boolean-Wert ab oder legt einen fest, der angibt, ob detaillierte Nachrichten angezeigt werden sollen, wenn ein Fehler in einem Unterbericht auftritt.

Zum Seitenanfang

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 angegebene Assembly zur Liste der Assemblys hinzu, die für die Ausführung in der aktuellen AppDomain vertrauenswürdig sind.
	Dispose	Gibt alle vom LocalReport-Objekt verwendeten Ressourcen frei.
	Equals	Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. (Von Object geerbt.)
	ExecuteReportInCurrentAppDomain	Veraltet. Verursacht Verarbeitungserweiterungen und -ausdrücke im Bericht, der in der aktuellen AppDomain ausgeführt werden soll.
	ExecuteReportInSandboxAppDomain	Veraltet. Verursacht Verarbeitungserweiterungen und -ausdrücke, die in einer Anwendungsdomain mit beschränkten Berechtigungen ausgeführt werden sollen.
	GetDataSourceNames	Gibt die Namen aller innerhalb des lokalen Berichts verwendeten Datensatzes 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. (Von Report geerbt.)
	GetHashCode	Fungiert als die Standardhashfunktion. (Von Object geerbt.)
	GetParameters	Gibt Berichtsparametereigenschaften für den Bericht zurück. (Überschreibt Report.GetParameters().)
	GetTotalPages()	Gibt die Gesamtzahl der Softwareseiten im Bericht zurück. (Von Report geerbt.)
	GetTotalPages(PageCountMode%)	Gibt die Gesamtzahl der Bildschirmseiten im Bericht und einen PageCountMode-Enumerationswert zurück, der den aktuellen Seitenzählmodus angibt. (Überschreibt Report.GetTotalPages(PageCountMode%).)
	GetType	Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
	ListRenderingExtensions	Gibt alle verfügbaren Renderingerweiterungen für den lokalen Bericht zurück. (Überschreibt Report.ListRenderingExtensions().)
	LoadReportDefinition(TextReader)	Lädt eine Berichtsdefinition aus dem lokalen Dateisystem mithilfe eines TextReader. (Überschreibt Report.LoadReportDefinition(TextReader).)
	LoadReportDefinition(Stream)	Lädt eine Berichtsdefinition für die Verarbeitung per Stream. (Von Report geerbt.)
	LoadSubreportDefinition(String, Stream)	Lädt eine Unterberichtsdefinition mithilfe eines Stream.
	LoadSubreportDefinition(String, TextReader)	Lädt eine Unterberichtsdefinition mithilfe eines TextReader.
	Refresh	Bewirkt, dass der lokale Bericht mit neuen Daten gerendert wird. (Überschreibt Report.Refresh().)
	ReleaseSandboxAppDomain	Bewirkt, dass das LocalReport-Objekt sofort seinen Verweis auf die Sandbox-Anwendungsdomäne freigibt.
	Render(String)	Verarbeitet den Bericht und rendert ihn im angegebenen Format. (Von Report geerbt.)
	Render(String, String)	Verarbeitet den Bericht und rendert ihn im angegebenen Format. (Von Report geerbt.)
	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. (Von Report geerbt.)
	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. (Von Report geerbt.)
	ToString	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)

Zum Seitenanfang

Ereignisse

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

Zum Seitenanfang

Explizite Schnittstellenimplementierungen

	Name	Beschreibung
	ISerializable.GetObjectData

Zum Seitenanfang

Hinweise

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 nonvisual 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.

Beispiele

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

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)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Siehe auch

Referenz

Microsoft.Reporting.WinForms-Namespace