Compartir a través de

Clase LocalReport

  • Artículo

Representa un informe que se procesa y se representa localmente sin conectarse a un servidor de informes.

Jerarquía de herencia

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

Espacio de nombres:  Microsoft.Reporting.WebForms
Ensamblado:  Microsoft.ReportViewer.WebForms (en Microsoft.ReportViewer.WebForms.dll)

Sintaxis

'Declaración
<SerializableAttribute> _
Public NotInheritable Class LocalReport _
    Inherits Report _
    Implements ISerializable, IDisposable
'Uso
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

El tipo LocalReport expone los siguientes miembros.

Constructores

  Nombre Descripción
Método público LocalReport Inicializa una nueva instancia de la clase LocalReport.

Arriba

Propiedades

  Nombre Descripción
Propiedad pública DataSources Obtiene una colección de los orígenes de datos utilizados por el informe.
Propiedad pública DisplayName Obtiene o establece el nombre para mostrar del informe. (Se hereda de Report.)
Propiedad pública EnableExternalImages Indica si el informe se puede representar si contiene imágenes externas.
Propiedad pública EnableHyperlinks Indica si el informe se puede representar si contiene acciones de hipervínculos.
Propiedad pública IsDrillthroughReport Indica si el informe es un informe de obtención de detalles. (Se hereda de Report.)
Propiedad pública IsReadyForRendering Obtiene un valor Boolean que indica si se han especificado una definición de informe y todos sus parámetros, y si todos los orígenes de datos están preparados para utilizarlos. (Se hereda de Report.)
Propiedad pública OriginalParametersToDrillthrough Si este es un informe de obtención de detalles, devuelve los parámetros que se le pasan desde el informe primario.
Propiedad pública ReportEmbeddedResource Obtiene o establece el nombre del recurso incrustado del informe.
Propiedad pública ReportPath Obtiene o establece la ruta de acceso al sistema de archivos local del informe local.
Propiedad pública ShowDetailedSubreportMessages Obtiene o establece un valor Boolean que indica si se deben mostrar los mensajes detallados cuando se produce un error en un subinforme.

Arriba

Métodos

  Nombre Descripción
Método público AddFullTrustModuleInSandboxAppDomain Agrega el ensamblado proporcionado a la lista de ensamblados que se ejecutan en modo de plena confianza en el dominio de aplicación de espacio aislado.
Método público AddTrustedCodeModuleInCurrentAppDomain Obsoleto. Agrega el ensamblado suministrado a la lista de ensamblados de confianza para la ejecución en el AppDomain actual.
Método público Dispose Libera todos los recursos utilizados por el objeto LocalReport.
Método público Equals (Se hereda de Object.)
Método público ExecuteReportInCurrentAppDomain Obsoleto. Provoca la ejecución de las extensiones y expresiones de procesamiento del informe en el AppDomain actual.
Método público ExecuteReportInSandboxAppDomain Obsoleto. Provoca que las extensiones y expresiones de procesamiento se ejecuten con permisos limitados en un dominio de aplicación.
Método protegido Finalize (Se hereda de Object.)
Método público GetDataSourceNames Devuelve los nombres de todos los conjuntos de datos utilizados en el informe local.
Método público GetDefaultPageSettings Obtiene la configuración predeterminada de la página especificada en el informe local. (Invalida Report.GetDefaultPageSettings().)
Método público GetDocumentMap Devuelve la representación del mapa del documento del informe local. (Se hereda de Report.)
Método público GetHashCode (Se hereda de Object.)
Método público GetParameters Devuelve las propiedades de parámetros del informe para el informe. (Invalida Report.GetParameters().)
Método público GetTotalPages() Devuelve el número total de saltos de página automáticos del informe. (Se hereda de Report.)
Método público GetTotalPages(PageCountMode%) Devuelve el número total de saltos de página automáticos del informe y un valor de la enumeración PageCountMode que indica el modo de recuento de páginas actual. (Invalida Report.GetTotalPages(PageCountMode%).)
Método público GetType (Se hereda de Object.)
Método público ListRenderingExtensions Devuelve todas las extensiones de presentación disponibles para el informe local. (Invalida Report.ListRenderingExtensions().)
Método público LoadReportDefinition(TextReader) Carga una definición de informe desde el sistema de archivos local mediante TextReader. (Invalida Report.LoadReportDefinition(TextReader).)
Método público LoadReportDefinition(Stream) Carga una definición de informe para procesarla utilizando un objeto Stream. (Se hereda de Report.)
Método público LoadSubreportDefinition(String, Stream) Carga una definición de subinforme mediante Stream.
Método público LoadSubreportDefinition(String, TextReader) Carga una definición de subinforme mediante TextReader.
Método protegido MemberwiseClone (Se hereda de Object.)
Método público Refresh Provoca que el informe local se presente con nuevos datos. (Invalida Report.Refresh().)
Método público ReleaseSandboxAppDomain Hace que el objeto LocalReport libere su referencia al dominio de aplicación de espacio aislado de forma inmediata.
Método público Render(String) Procesa el informe y lo representa en el formato especificado. (Se hereda de Report.)
Método público Render(String, String) Procesa el informe y lo representa en el formato especificado. (Se hereda de Report.)
Método público Render(String, String, CreateStreamCallback, array<Warning[]%) Procesa el informe y lo presenta en el formato especificado mediante una secuencia proporcionada por una función de devolución de llamada.
Método público Render(String, String, PageCountMode, CreateStreamCallback, array<Warning[]%) Procesa el informe con un modo de recuento de páginas especificado y lo presenta en el formato especificado mediante una secuencia proporcionada por una función de devolución de llamada.
Método público Render(String, String, String%, String%, String%, array<String[]%, array<Warning[]%) Procesa el informe y lo presenta en el formato especificado. (Se hereda de Report.)
Método público Render(String, String, PageCountMode, String%, String%, String%, array<String[]%, array<Warning[]%) Procesa el informe con un modo de recuento de páginas específico y lo representa en el formato especificado. (Invalida Report.Render(String, String, PageCountMode, String%, String%, String%, array<String[]%, array<Warning[]%).)
Método público SetBasePermissionsForSandboxAppDomain Establece los permisos base para el dominio de aplicación de espacio aislado con el conjunto de permisos proporcionado.
Método público SetParameters(IEnumerable<ReportParameter>) Establece las propiedades de parámetros de informe del informe local. (Invalida Report.SetParameters(IEnumerable<ReportParameter>).)
Método público SetParameters(ReportParameter) Establece las propiedades de los parámetros de informe para el informe. (Se hereda de Report.)
Método público ToString (Se hereda de Object.)

Arriba

Eventos

  Nombre Descripción
Evento público SubreportProcessing Ocurre cuando se procesa un subinforme.

Arriba

Implementaciones de interfaces explícitas

  Nombre Descripción
Implementación de interfaces explícitasMétodo privado ISerializable.GetObjectData

Arriba

Comentarios

La clase LocalReport presenta los informes que se procesan y se presentan localmente sin conectarse a un servidor de informes. Esta clase es el mismo objeto que utiliza el control ReportViewer, pero también se puede utilizar independientemente como un objeto no visual que encapsula la funcionalidad básica del control ReportViewer.

El objeto LocalReport puede abrir los archivos de definición de informe de cliente (RDLC) desde el sistema de archivos o desde recursos incrustados, o el archivo RDLC puede suministrársele como un objeto Stream o TextReader.

El objeto LocalReport no permite ejecutar consultas ni capturar datos; es necesario agregar los orígenes de datos a la propiedad de colección DataSources.

El objeto LocalReport admite el uso de parámetros de informe, pero no los mensajes de parámetros.

Ejemplos

En el siguiente ejemplo de código, se utiliza un objeto LocalReport para cargar y exportar un informe.

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

Seguridad para subprocesos

Cualquier miembro público static (Shared en Visual Basic) de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Vea también

Referencia

Espacio de nombres Microsoft.Reporting.WebForms