Classe LocalReport

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

Gerarchia di ereditarietà

System.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
'Utilizzo
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

Nel tipo LocalReport sono esposti i membri seguenti.

Costruttori

	Nome	Descrizione
	LocalReport	Inizializza un'istanza nuova della classe LocalReport.

In alto

Proprietà

	Nome	Descrizione
	DataSources	Recupera una raccolta di origini dati utilizzate dal rapporto.
	DisplayName	Recupera o imposta il nome visualizzato del rapporto. Ereditato da Report.
	EnableExternalImages	Indica se è possibile eseguire il rendering di un rapporto che include immagini esterne.
	EnableHyperlinks	Indica se è possibile eseguire il rendering di un rapporto che contiene azioni collegamento ipertestuale.
	IsDrillthroughReport	Indica se il rapporto è di tipo drill-through. Ereditato da Report.
	IsReadyForRendering	Recupera un valore Boolean 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.
	OriginalParametersToDrillthrough	Restituisce i parametri passati da un rapporto padre a questo rapporto, se si tratta di un rapporto drill-through.
	ReportEmbeddedResource	Recupera o imposta il nome della risorsa incorporata del rapporto.
	ReportPath	Recupera o imposta il percorso del rapporto locale nel file system locale.
	ShowDetailedSubreportMessages	Recupera o imposta un valore Boolean che indica se devono essere visualizzati messaggi dettagliati quando si verifica un errore in un sottorapporto.

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 specificato all'elenco di assembly attendibili per l'esecuzione nell'oggetto AppDomain corrente.
	Dispose	Rilascia tutte le risorse utilizzate dall'oggetto LocalReport.
	Equals	Ereditato da Object.
	ExecuteReportInCurrentAppDomain	Obsoleto. Determina l'esecuzione delle espressioni e delle estensioni per l'elaborazione del rapporto nell'oggetto AppDomain corrente.
	ExecuteReportInSandboxAppDomain	Obsoleto. Determina l'esecuzione delle espressioni e delle estensioni per l'elaborazione in un dominio applicazione con autorizzazioni limitate.
	Finalize	Ereditato da Object.
	GetDataSourceNames	Restituisce i nomi di tutti i set di dati utilizzati nel rapporto locale.
	GetDefaultPageSettings	Recupera le impostazioni di pagina predefinite specificate nel rapporto locale. Esegue l'override di Report.GetDefaultPageSettings().
	GetDocumentMap	Restituisce la rappresentazione della mappa documento per il rapporto locale. Ereditato da Report.
	GetHashCode	Ereditato da Object.
	GetParameters	Restituisce le proprietà dei parametri di rapporto per il rapporto. 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 rapporto e un valore dell'enumerazione PageCountMode che indica la modalità di conteggio delle pagine corrente. Esegue l'override di Report.GetTotalPages(PageCountMode%).
	GetType	Ereditato da Object.
	ListRenderingExtensions	Restituisce tutte le estensioni per il rendering disponibili per il rapporto locale. Esegue l'override di Report.ListRenderingExtensions().
	LoadReportDefinition(TextReader)	Carica una definizione del rapporto dal file system locale utilizzando 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 sottorapporto utilizzando un oggetto Stream.
	LoadSubreportDefinition(String, TextReader)	Carica una definizione di sottorapporto utilizzando un oggetto TextReader.
	MemberwiseClone	Ereditato da Object.
	Refresh	Determina l'esecuzione del rendering del rapporto locale con i dati più recenti. Esegue l'override di Report.Refresh().
	ReleaseSandboxAppDomain	Fa in modo che l'oggetto LocalReport rilasci immediatamente il riferimento al dominio applicazione in modalità 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 rapporto 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 rapporto 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 rapporto 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 rapporto per il rapporto 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	Ereditato da Object.

In alto

Eventi

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

In alto

Implementazioni esplicite dell'interfaccia

	Nome	Descrizione
	ISerializable.GetObjectData

In alto

Osservazioni

La classe LocalReport rappresenta i rapporti di cui vengono eseguiti l'elaborazione e il rendering a livello locale senza connettersi a un server di rapporti. Questa classe corrisponde all'oggetto utilizzato dal controllo ReportViewer, ma può anche essere utilizzata in modo indipendente come oggetto non visivo che incapsula le funzionalità principali del controllo ReportViewer.

L'oggetto LocalReport consente di aprire file di definizione dei rapporti del client (con estensione rdlc) dal file system o da risorse incorporate. In alternativa, è possibile fornire il file con estensione rdlc a tale oggetto come Stream o TextReader.

L'oggetto LocalReport non consente il recupero di dati o l'esecuzione di query. A tale scopo è invece necessario aggiungere le origini dati alla proprietà di raccolta DataSources.

L'oggetto LocalReport supporta i parametri di rapporto ma non i messaggi di richiesta dei parametri.

Esempi

Nell'esempio di codice seguente viene utilizzato un oggetto LocalReport per il caricamento e l'esportazione di un rapporto.

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

Protezione dei thread

I membri static (Shared in Visual Basic) pubblici di questo tipo sono affidabili. Non è invece garantita la sicurezza dei membri dell'istanza.

Vedere anche

Riferimento

Spazio dei nomi Microsoft.Reporting.WebForms