Поделиться через

Класс LocalReport

  • Статья

Представляет отчет, который обрабатывается и готовится к просмотру локально, без соединения с сервером отчетов.

Иерархия наследования

System.Object
  Microsoft.Reporting.WinForms.Report
    Microsoft.Reporting.WinForms.LocalReport

Пространство имен:  Microsoft.Reporting.WinForms
Сборка:  Microsoft.ReportViewer.WinForms (в Microsoft.ReportViewer.WinForms.dll)

Синтаксис

'Декларация
<SerializableAttribute> _
Public NotInheritable Class LocalReport _
    Inherits Report _
    Implements ISerializable, IDisposable
'Применение
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

Тип LocalReport обеспечивает доступ к следующим элементам.

Конструкторы

  Имя Описание
Открытый метод LocalReport Инициализирует новый экземпляр класса LocalReport.

В начало

Свойства

  Имя Описание
Открытое свойство DataSources Возвращает коллекцию источников данных, используемых отчетом.
Открытое свойство DisplayName Возвращает или задает отображаемое имя отчета. (Производный от Report.)
Открытое свойство EnableExternalImages Показывает, возможна ли подготовка отчета к просмотру, если он содержит внешние изображения.
Открытое свойство EnableHyperlinks Показывает, возможна ли подготовка отчета к просмотру, если он содержит действия с гиперссылками.
Открытое свойство IsDrillthroughReport Показывает, является ли отчет детализированным. (Производный от Report.)
Открытое свойство IsReadyForRendering Возвращает значение типа Boolean, показывающее, задано ли определение отчета и все требуемые параметры и готовы ли все источники данных к использованию. (Производный от Report.)
Открытое свойство OriginalParametersToDrillthrough Возвращает параметры, переданные из родительского отчета в этот отчет, если он является детализированным.
Открытое свойство ReportEmbeddedResource Возвращает или задает имя внедренного ресурса отчета.
Открытое свойство ReportPath Возвращает или задает системный путь файла локального отчета.
Открытое свойство ShowDetailedSubreportMessages Получает или задает значение типа boolean, которое определяет, должны ли при ошибке во вложенном отчете отображаться подробные сообщения.

В начало

Методы

  Имя Описание
Открытый метод AddFullTrustModuleInSandboxAppDomain Добавляет переданную сборку в список сборок, которые работают в режиме полного доверия в изолированном домене приложения.
Открытый метод AddTrustedCodeModuleInCurrentAppDomain Устарело. Добавляет переданную сборку в список сборок, которым доверяется выполнение в текущем домене AppDomain.
Открытый метод Dispose Освобождает все ресурсы, занятые объектом LocalReport.
Открытый метод Equals (Производный от Object.)
Открытый метод ExecuteReportInCurrentAppDomain Устарело. Задает для модулей обработки данных и выражений в отчете выполнение в текущем домене AppDomain.
Открытый метод ExecuteReportInSandboxAppDomain Устарело. Вызывает запуск модулей обработки и выражений с ограниченными разрешениями в домене приложения.
Защищенный метод Finalize (Производный от Object.)
Открытый метод GetDataSourceNames Возвращает имена всех наборов данных, используемых в локальном отчете.
Открытый метод GetDefaultPageSettings Возвращает параметры страницы по умолчанию, указанные в локальном отчете. (Переопределяет Report.GetDefaultPageSettings().)
Открытый метод GetDocumentMap Возвращает представление схемы документа для локального отчета. (Производный от Report.)
Открытый метод GetHashCode (Производный от Object.)
Открытый метод GetParameters Возвращает свойства параметров отчета. (Переопределяет Report.GetParameters().)
Открытый метод GetTotalPages() Возвращает общее число «мягких» страниц в отчете. (Производный от Report.)
Открытый метод GetTotalPages(PageCountMode%) Возвращает общее число «мягких» страниц в отчете и значение перечисления PageCountMode, показывающее текущий режим подсчета страниц. (Переопределяет Report.GetTotalPages(PageCountMode%).)
Открытый метод GetType (Производный от Object.)
Открытый метод ListRenderingExtensions Возвращает все доступные модули подготовки для локального отчета. (Переопределяет Report.ListRenderingExtensions().)
Открытый метод LoadReportDefinition(TextReader) Загружает определение отчета из локальной файловой системы с помощью TextReader. (Переопределяет Report.LoadReportDefinition(TextReader).)
Открытый метод LoadReportDefinition(Stream) Загружает определение отчета для обработки с использованием объекта Stream. (Производный от Report.)
Открытый метод LoadSubreportDefinition(String, Stream) Загружает определение вложенного отчета с помощью Stream.
Открытый метод LoadSubreportDefinition(String, TextReader) Загружает определение вложенного отчета с помощью TextReader.
Защищенный метод MemberwiseClone (Производный от Object.)
Открытый метод Refresh Вызывает подготовку локального отчета к просмотру с новыми данными. (Переопределяет Report.Refresh().)
Открытый метод ReleaseSandboxAppDomain Вызывает немедленное освобождение объектом LocalReport ссылки на изолированный домен приложения «песочницы».
Открытый метод Render(String) Обрабатывает отчет и готовит его к просмотру в заданном формате. (Производный от Report.)
Открытый метод Render(String, String) Обрабатывает отчет и готовит его к просмотру в заданном формате. (Производный от Report.)
Открытый метод Render(String, String, CreateStreamCallback, array<Warning[]%) Обрабатывает отчет и готовит его к просмотру в указанном формате, используя поток, переданный функцией обратного вызова.
Открытый метод Render(String, String, PageCountMode, CreateStreamCallback, array<Warning[]%) Обрабатывает отчет, используя заданный режим счетчика страниц, и готовит его к просмотру в указанном формате, используя поток, переданный функцией обратного вызова.
Открытый метод Render(String, String, String%, String%, String%, array<String[]%, array<Warning[]%) Обрабатывает отчет и готовит его к просмотру в заданном формате. (Производный от Report.)
Открытый метод Render(String, String, PageCountMode, String%, String%, String%, array<String[]%, array<Warning[]%) Обрабатывает отчет в указанном режиме подсчета страниц и готовит его к просмотру в указанном формате. (Переопределяет Report.Render(String, String, PageCountMode, String%, String%, String%, array<String[]%, array<Warning[]%).)
Открытый метод SetBasePermissionsForSandboxAppDomain Задает базовые разрешения для изолированного домена приложения, используя заданный набор разрешений.
Открытый метод SetParameters(IEnumerable<ReportParameter>) Задает свойства параметров для локального отчета. (Переопределяет Report.SetParameters(IEnumerable<ReportParameter>).)
Открытый метод SetParameters(ReportParameter) Задает свойства параметров для отчета. (Производный от Report.)
Открытый метод ToString (Производный от Object.)

В начало

События

  Имя Описание
Открытое событие SubreportProcessing Происходит при обработке вложенного отчета.

В начало

Явные реализации интерфейса

  Имя Описание
Явная реализация интерфейсаЗакрытый метод ISerializable.GetObjectData

В начало

Замечания

Класс LocalReport представляет отчеты, которые обрабатываются и готовятся к просмотру локально, без соединения с сервером отчетов. Этот класс является тем же объектом, который используется элементом управления ReportViewer, но его можно использовать и независимо — в качестве невизуального объекта, инкапсулирующего основные функциональные возможности элемента управления ReportViewer.

Объект LocalReport может открывать RDLC-файлы из файловой системы или из внедренных ресурсов. Также можно передавать RDLC-файл в этот объект в виде объекта Stream или TextReader.

Объект LocalReport не может выполнять запросы и получать данные. Вместо этого источники данных должны добавляться в свойство коллекции DataSources.

Объект LocalReport поддерживает параметры отчета, но не поддерживает запросы на ввод параметров.

Примеры

В следующем примере кода объект LocalReport используется для загрузки и экспорта отчета.

private void button1_Click(object sender, EventArgs e)
{

   Microsoft.Reporting.WinForms.LocalReport lr = new Microsoft.Reporting.WinForms.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);
      }
}

Private Sub Button1_Click(ByVal sender As System.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()

   deviceInfo = "< deviceInfo ><SimplePageHeaders>True</SimplePageHeaders></DeviceInfo>"

   bytes = ReportViewer1.LocalReport.Render("Excel", Nothing, _
     mimeType,encoding, extension, streamids, warnings)

   Dim fs As New FileStream("c:\output.xls", FileMode.Create)
   fs.Write(bytes, 0, bytes.Length)

   MessageBox.Show("Report exported to output.xls", "Info")
End Sub

Безопасность многопоточности

Любые открытые статический (Shared в Visual Basic) элементы этого типа потокобезопасны. Потокобезопасность с элементами экземпляров не гарантируется.

См. также

Справочник

Пространство имен Microsoft.Reporting.WinForms