Classe LocalReport

Rappresenta un report di cui vengono eseguiti l'elaborazione e il rendering a livello locale senza connettersi a un server di report.

Gerarchia di ereditarietà

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

Spazio dei nomi:  Microsoft.Reporting.WebForms
Assembly:  Microsoft.ReportViewer.WebForms (in Microsoft.ReportViewer.WebForms.dll)

Sintassi

'Dichiarazione
<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

Il tipo LocalReport espone i seguenti membri.

Costruttori

	Nome	Descrizione
	LocalReport	Inizializza una nuova istanza della classe LocalReport.

In alto

Proprietà

	Nome	Descrizione
	DataSources	Recupera una raccolta di origini dati usate dal report.
	DisplayName	Recupera o imposta il nome visualizzato del rapporto. (Ereditato da Report)
	EnableExternalImages	Indica se è possibile eseguire il rendering di un report che include immagini esterne.
	EnableHyperlinks	Indica se è possibile eseguire il rendering di un report che contiene azioni collegamento ipertestuale.
	IsDrillthroughReport	Indica se il rapporto è di tipo drill-through. (Ereditato da Report)
	IsReadyForRendering	Recupera un valore booleano che indica se sono stati specificati una definizione del rapporto e tutti i parametri e se tutte le origini dati sono pronte per l'uso. (Ereditato da Report)
	MapTileServerConfiguration	Definisce le impostazioni di configurazione per i servizi SOAP di Microsoft Bing Maps che forniscono uno sfondo a sezioni per gli elementi del report mappa nel report.
	OriginalParametersToDrillthrough	Restituisce i parametri passati da un report padre a questo report, se si tratta di un report drill-through.
	ReportEmbeddedResource	Ottiene o imposta il nome della risorsa incorporata del report.
	ReportPath	Ottiene o imposta il percorso del report locale nel file system locale.
	ShowDetailedSubreportMessages	Ottiene o imposta un valore Boolean che indica se devono essere visualizzati messaggi dettagliati quando si verifica un errore in un sottoreport.

In alto

Metodi

	Nome	Descrizione
	AddFullTrustModuleInSandboxAppDomain	Aggiunge l'assembly fornito all'elenco di assembly eseguiti in modalità di attendibilità totale nel dominio applicazione in modalità sandbox.
	AddTrustedCodeModuleInCurrentAppDomain	Obsoleto. Aggiunge l'assembly fornito all'elenco di assembly attendibili per l'esecuzione nell'oggetto AppDomain corrente.
	Dispose	Rilascia tutte le risorse usate dall'oggetto LocalReport.
	Equals	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
	ExecuteReportInCurrentAppDomain	Obsoleto. Determina l'esecuzione delle espressioni e delle estensioni per l'elaborazione del report nell'oggetto AppDomain corrente.
	ExecuteReportInSandboxAppDomain	Obsoleto. Determina l'esecuzione delle espressioni e delle estensioni per l'elaborazione in un dominio applicazione con autorizzazioni limitate.
	GetDataSourceNames	Restituisce i nomi di tutti i set di dati usati nel report locale.
	GetDefaultPageSettings	Recupera le impostazioni di pagina predefinite specificate nel report locale. (Esegue l'override di Report.GetDefaultPageSettings()).
	GetDocumentMap	Restituisce la rappresentazione della mappa documento per il rapporto locale. (Ereditato da Report)
	GetHashCode	Funge da funzione hash predefinita. (Ereditato da Object)
	GetParameters	Restituisce le proprietà dei parametri per il report. (Esegue l'override di Report.GetParameters()).
	GetTotalPages()	Restituisce il numero totale di pagine software del rapporto. (Ereditato da Report)
	GetTotalPages(PageCountMode%)	Restituisce il numero totale di pagine software di un report e un valore dell'enumerazione PageCountMode che indica la modalità di conteggio delle pagine corrente. (Esegue l'override di Report.GetTotalPages(PageCountMode%)).
	GetType	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
	ListRenderingExtensions	Restituisce tutte le estensioni per il rendering disponibili per il report locale. (Esegue l'override di Report.ListRenderingExtensions()).
	LoadReportDefinition(TextReader)	Carica una definizione del report dal file system locale usando un oggetto TextReader. (Esegue l'override di Report.LoadReportDefinition(TextReader)).
	LoadReportDefinition(Stream)	Carica una definizione del rapporto per l'elaborazione utilizzando un oggetto Stream. (Ereditato da Report)
	LoadSubreportDefinition(String, Stream)	Carica una definizione del sottoreport usando un oggetto Stream.
	LoadSubreportDefinition(String, TextReader)	Carica una definizione del sottoreport usando un oggetto TextReader.
	Refresh	Determina l'esecuzione del rendering del report locale con i dati più recenti. (Esegue l'override di Report.Refresh()).
	ReleaseSandboxAppDomain	Nell'oggetto LocalReport causa il rilascio immediato del riferimento al dominio applicazione creato mediante sandbox.
	Render(String)	Elabora il rapporto e ne esegue il rendering nel formato specificato. (Ereditato da Report)
	Render(String, String)	Elabora il rapporto e ne esegue il rendering nel formato specificato. (Ereditato da Report)
	Render(String, String, CreateStreamCallback, array<Warning[]%)	Elabora il report e ne esegue il rendering nel formato specificato utilizzando il flusso restituito da una funzione di richiamata.
	Render(String, String, PageCountMode, CreateStreamCallback, array<Warning[]%)	Elabora il report con una modalità specificata di conteggio delle pagine e ne esegue il rendering nel formato specificato utilizzando il flusso restituito da una funzione di richiamata.
	Render(String, String, String%, String%, String%, array<String[]%, array<Warning[]%)	Elabora il rapporto e ne esegue il rendering nel formato specificato. (Ereditato da Report)
	Render(String, String, PageCountMode, String%, String%, String%, array<String[]%, array<Warning[]%)	Elabora il report con una modalità di conteggio delle pagine specificata e ne esegue il rendering nel formato specificato. (Esegue l'override di Report.Render(String, String, PageCountMode, String%, String%, String%, array<String[]%, array<Warning[]%)).
	SetBasePermissionsForSandboxAppDomain	Imposta le autorizzazioni di base per il dominio applicazione in modalità sandbox con il set di autorizzazioni fornito.
	SetParameters(IEnumerable<ReportParameter>)	Imposta le proprietà dei parametri di report per il report locale. (Esegue l'override di Report.SetParameters(IEnumerable<ReportParameter>)).
	SetParameters(ReportParameter)	Imposta le proprietà dei parametri di rapporto per il rapporto. (Ereditato da Report)
	ToString	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

In alto

Eventi

	Nome	Descrizione
	SubreportProcessing	Si verifica durante l'elaborazione di un sottoreport.

In alto

Implementazioni esplicite dell'interfaccia

	Nome	Descrizione
	ISerializable.GetObjectData

In alto

Note

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

Esempi

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

Codice thread safe

Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.

Vedere anche

Riferimenti

Spazio dei nomi Microsoft.Reporting.WebForms