Condividi tramite


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
Metodo pubblico LocalReport Inizializza un'istanza nuova della classe LocalReport.

In alto

Proprietà

  Nome Descrizione
Proprietà pubblica DataSources Recupera una raccolta di origini dati utilizzate dal rapporto.
Proprietà pubblica DisplayName Recupera o imposta il nome visualizzato del rapporto. Ereditato da Report.
Proprietà pubblica EnableExternalImages Indica se è possibile eseguire il rendering di un rapporto che include immagini esterne.
Proprietà pubblica EnableHyperlinks Indica se è possibile eseguire il rendering di un rapporto che contiene azioni collegamento ipertestuale.
Proprietà pubblica IsDrillthroughReport Indica se il rapporto è di tipo drill-through. Ereditato da Report.
Proprietà pubblica 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.
Proprietà pubblica OriginalParametersToDrillthrough Restituisce i parametri passati da un rapporto padre a questo rapporto, se si tratta di un rapporto drill-through.
Proprietà pubblica ReportEmbeddedResource Recupera o imposta il nome della risorsa incorporata del rapporto.
Proprietà pubblica ReportPath Recupera o imposta il percorso del rapporto locale nel file system locale.
Proprietà pubblica 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
Metodo pubblico AddFullTrustModuleInSandboxAppDomain Aggiunge l'assembly fornito all'elenco di assembly eseguiti in modalità di attendibilità totale nel dominio applicazione in modalità sandbox.
Metodo pubblico AddTrustedCodeModuleInCurrentAppDomain Obsoleto. Aggiunge l'assembly specificato all'elenco di assembly attendibili per l'esecuzione nell'oggetto AppDomain corrente.
Metodo pubblico Dispose Rilascia tutte le risorse utilizzate dall'oggetto LocalReport.
Metodo pubblico Equals Ereditato da Object.
Metodo pubblico ExecuteReportInCurrentAppDomain Obsoleto. Determina l'esecuzione delle espressioni e delle estensioni per l'elaborazione del rapporto nell'oggetto AppDomain corrente.
Metodo pubblico ExecuteReportInSandboxAppDomain Obsoleto. Determina l'esecuzione delle espressioni e delle estensioni per l'elaborazione in un dominio applicazione con autorizzazioni limitate.
Metodo protetto Finalize Ereditato da Object.
Metodo pubblico GetDataSourceNames Restituisce i nomi di tutti i set di dati utilizzati nel rapporto locale.
Metodo pubblico GetDefaultPageSettings Recupera le impostazioni di pagina predefinite specificate nel rapporto locale. Esegue l'override di Report.GetDefaultPageSettings().
Metodo pubblico GetDocumentMap Restituisce la rappresentazione della mappa documento per il rapporto locale. Ereditato da Report.
Metodo pubblico GetHashCode Ereditato da Object.
Metodo pubblico GetParameters Restituisce le proprietà dei parametri di rapporto per il rapporto. Esegue l'override di Report.GetParameters().
Metodo pubblico GetTotalPages() Restituisce il numero totale di pagine software del rapporto. Ereditato da Report.
Metodo pubblico 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%).
Metodo pubblico GetType Ereditato da Object.
Metodo pubblico ListRenderingExtensions Restituisce tutte le estensioni per il rendering disponibili per il rapporto locale. Esegue l'override di Report.ListRenderingExtensions().
Metodo pubblico LoadReportDefinition(TextReader) Carica una definizione del rapporto dal file system locale utilizzando un oggetto TextReader. Esegue l'override di Report.LoadReportDefinition(TextReader).
Metodo pubblico LoadReportDefinition(Stream) Carica una definizione del rapporto per l'elaborazione utilizzando un oggetto Stream. Ereditato da Report.
Metodo pubblico LoadSubreportDefinition(String, Stream) Carica una definizione del sottorapporto utilizzando un oggetto Stream.
Metodo pubblico LoadSubreportDefinition(String, TextReader) Carica una definizione di sottorapporto utilizzando un oggetto TextReader.
Metodo protetto MemberwiseClone Ereditato da Object.
Metodo pubblico Refresh Determina l'esecuzione del rendering del rapporto locale con i dati più recenti. Esegue l'override di Report.Refresh().
Metodo pubblico ReleaseSandboxAppDomain Fa in modo che l'oggetto LocalReport rilasci immediatamente il riferimento al dominio applicazione in modalità sandbox.
Metodo pubblico Render(String) Elabora il rapporto e ne esegue il rendering nel formato specificato. Ereditato da Report.
Metodo pubblico Render(String, String) Elabora il rapporto e ne esegue il rendering nel formato specificato. Ereditato da Report.
Metodo pubblico 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.
Metodo pubblico 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.
Metodo pubblico Render(String, String, String%, String%, String%, array<String[]%, array<Warning[]%) Elabora il rapporto e ne esegue il rendering nel formato specificato. Ereditato da Report.
Metodo pubblico 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[]%).
Metodo pubblico SetBasePermissionsForSandboxAppDomain Imposta le autorizzazioni di base per il dominio applicazione in modalità sandbox con il set di autorizzazioni fornito.
Metodo pubblico SetParameters(IEnumerable<ReportParameter>) Imposta le proprietà dei parametri di rapporto per il rapporto locale. Esegue l'override di Report.SetParameters(IEnumerable<ReportParameter>).
Metodo pubblico SetParameters(ReportParameter) Imposta le proprietà dei parametri di rapporto per il rapporto. Ereditato da Report.
Metodo pubblico ToString Ereditato da Object.

In alto

Eventi

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

In alto

Implementazioni esplicite dell'interfaccia

  Nome Descrizione
Implementazione esplicita dell'interfacciaMetodo privato 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