LocalReport (Clase)

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

Jerarquía de herencia

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

[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

El tipo LocalReport expone los siguientes miembros.

Constructores

	Nombre	Descripción
	LocalReport	Inicializa una nueva instancia de la clase LocalReport.

Arriba

Propiedades

	Nombre	Descripción
	DataSources	Obtiene una colección de los orígenes de datos utilizados por el informe.
	DisplayName	Obtiene o establece el nombre para mostrar del informe. (Se hereda de Report).
	EnableExternalImages	Indica si el informe se puede representar si contiene imágenes externas.
	EnableHyperlinks	Indica si el informe se puede representar si contiene acciones de hipervínculos.
	IsDrillthroughReport	Indica si el informe es un informe de obtención de detalles. (Se hereda de Report).
	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).
	MapTileServerConfiguration	Define la configuración para los servicios SOAP de Microsoft Bing Maps que proporcionan un fondo de mosaico para los elementos de informe de mapa en el informe.
	OriginalParametersToDrillthrough	Si este es un informe de obtención de detalles, devuelve los parámetros que se le pasan desde el informe primario.
	ReportEmbeddedResource	Obtiene o establece el nombre del recurso incrustado del informe.
	ReportPath	Obtiene o establece la ruta de acceso al sistema de archivos local del informe local.
	ShowDetailedSubreportMessages	Obtiene o establece un valor Boolean, que indica si los mensajes detallados se deben mostrar cuando se produzca un error en un subinforme.

Arriba

Métodos

	Nombre	Descripción
	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.
	AddTrustedCodeModuleInCurrentAppDomain	Obsoleta. Agrega el ensamblado proporcionado a la lista de ensamblajes de confianza para ejecutarse en el elemento AppDomain actual.
	Dispose	Libera todos los recursos que usa el objeto LocalReport.
	Equals	Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
	ExecuteReportInCurrentAppDomain	Obsoleta. Hace que las extensiones y expresiones de procesamiento del informe se ejecuten en el elemento AppDomain actual.
	ExecuteReportInSandboxAppDomain	Obsoleta. Hace que las extensiones y expresiones de procesamiento se ejecuten con permisos limitados en un dominio de aplicación.
	GetDataSourceNames	Devuelve los nombres de todos los conjuntos de datos utilizados en el informe local.
	GetDefaultPageSettings	Obtiene la configuración predeterminada de la página especificada en el informe local. (Invalida a Report.GetDefaultPageSettings()).
	GetDocumentMap	Devuelve la representación del mapa del documento del informe local. (Se hereda de Report).
	GetHashCode	Sirve como la función hash predeterminada. (Se hereda de Object).
	GetParameters	Devuelve propiedades del parámetro de informe para el informe. (Invalida a Report.GetParameters()).
	GetTotalPages()	Devuelve el número total de saltos de página automáticos del informe. (Se hereda de Report).
	GetTotalPages(PageCountMode%)	Devuelve el número total de páginas en memoria del informe y un valor de enumeración PageCountMode que indica el modo de recuento de páginas actual. (Invalida a Report.GetTotalPages(PageCountMode%)).
	GetType	Obtiene el objeto Type de la instancia actual. (Se hereda de Object).
	ListRenderingExtensions	Devuelve todas las extensiones de representación disponibles para el informe local. (Invalida a Report.ListRenderingExtensions()).
	LoadReportDefinition(TextReader)	Carga una definición de informe del sistema de archivos local con un elemento TextReader. (Invalida a Report.LoadReportDefinition(TextReader)).
	LoadReportDefinition(Stream)	Carga una definición de informe para procesarla utilizando un objeto Stream. (Se hereda de Report).
	LoadSubreportDefinition(String, Stream)	Carga una definición de subinforme con una clase Stream.
	LoadSubreportDefinition(String, TextReader)	Carga una definición de subinforme con una clase TextReader.
	Refresh	Provoca que el informe local se represente con nuevos datos. (Invalida a Report.Refresh()).
	ReleaseSandboxAppDomain	Hace que el objeto LocalReport libere su referencia al dominio de aplicación en un espacio aislado de forma inmediata.
	Render(String)	Procesa el informe y lo representa en el formato especificado. (Se hereda de Report).
	Render(String, String)	Procesa el informe y lo representa en el formato especificado. (Se hereda de Report).
	Render(String, String, CreateStreamCallback, array<Warning[]%)	Procesa el informe y lo representa en el formato especificado mediante una secuencia proporcionada por una función de devolución de llamada.
	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.
	Render(String, String, String%, String%, String%, array<String[]%, array<Warning[]%)	Procesa el informe y lo presenta en el formato especificado. (Se hereda de Report).
	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 a Report.Render(String, String, PageCountMode, String%, String%, String%, array<String[]%, array<Warning[]%)).
	SetBasePermissionsForSandboxAppDomain	Establece los permisos base para el dominio de aplicación de espacio aislado con el conjunto de permisos proporcionado.
	SetParameters(IEnumerable<ReportParameter>)	Establece las propiedades de parámetros de informe del informe local. (Invalida a Report.SetParameters(IEnumerable<ReportParameter>)).
	SetParameters(ReportParameter)	Establece las propiedades de los parámetros de informe para el informe. (Se hereda de Report).
	ToString	Devuelve una cadena que representa el objeto actual. (Se hereda de Object).

Arriba

Eventos

	Nombre	Descripción
	SubreportProcessing	Ocurre cuando se procesa un subinforme.

Arriba

Implementaciones explícitas de interfaces

	Nombre	Descripción
	ISerializable.GetObjectData

Arriba

Comentarios

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

Ejemplos

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

Seguridad para subprocesos

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Vea también

Referencia

Microsoft.Reporting.WebForms (Espacio de nombres)