ReportExecutionService.Render2 Метод

Определение

Пространство имен:: ReportExecution2005

Сборка:: ReportExecution2005.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Обрабатывает конкретный отчет и отображает его в указанном формате.

public:
 cli::array <System::Byte> ^ Render2(System::String ^ Format, System::String ^ DeviceInfo, ReportExecution2005::PageCountMode PaginationMode, [Runtime::InteropServices::Out] System::String ^ % Extension, [Runtime::InteropServices::Out] System::String ^ % MimeType, [Runtime::InteropServices::Out] System::String ^ % Encoding, [Runtime::InteropServices::Out] cli::array <ReportExecution2005::Warning ^> ^ % Warnings, [Runtime::InteropServices::Out] cli::array <System::String ^> ^ % StreamIds);

public byte[] Render2(string Format, string DeviceInfo, ReportExecution2005.PageCountMode PaginationMode, out string Extension, out string MimeType, out string Encoding, out ReportExecution2005.Warning[] Warnings, out string[] StreamIds);

member this.Render2 : string * string * ReportExecution2005.PageCountMode * string * string * string * Warning[] * String[] -> byte[]

Public Function Render2 (Format As String, DeviceInfo As String, PaginationMode As PageCountMode, ByRef Extension As String, ByRef MimeType As String, ByRef Encoding As String, ByRef Warnings As Warning(), ByRef StreamIds As String()) As Byte()

Параметры

Format: String

Формат для отображения отчёта. Этот аргумент отображается в расширение рендеринга. Поддерживаемые расширения включают XML, NULL, CSV, IMAGE, PDF, HTML4.0, HTML3.2, MHTML, EXCEL и Word. Список поддерживаемых расширений можно получить, вызвав метод ListRenderingExtensions() .

DeviceInfo: String

XML-строка, содержащая специфическое для устройства содержимое и необходимое для расширения рендеринга, указанного в параметре Format . Настройки DeviceInfo должны передаваться как внутренние элементы XML-элемента DeviceInfo. Для получения дополнительной информации о настройках информации устройств для конкретных форматов вывода смотрите в разделе Настройки передачи информации устройства для расширений рендеринга.

PaginationMode: PageCountMode

Способ обработки отчёта.

Extension: String

[выход] Расширение файла, соответствующее выходному потоку.

MimeType: String

[выход] Тип MIME отображённого отчёта.

Encoding: String

[выход] Кодирование, используемое при сервере отчёта, отображает содержимое отчёта.

Warnings: Warning[]

[выход] Массив Warning объектов, описывающих любые предупреждения, возникшие во время обработки отчёта.

StreamIds: String[]

[выход] Идентификаторы потоков. Эти идентификаторы передаются методу RenderStream(String, String, String, String, String) . Вы можете использовать их для визуализации внешних ресурсов (изображений и т.д.), связанных с конкретным отчётом.

Возвращаемое значение

Byte[]

Массив Byte[] отчёта в указанном формате.


Использование разъёма SOAP	(В) TrustedUserHeaderValue (В) ExecutionHeaderValue (Выход) ServerInfoHeaderValue
Необходимые разрешения для нативного режима	О основном отчёте и всех подотчетах: ReadProperties И ExecuteAndView
Требуются разрешения для режима SharePoint	О основном отчёте и обо всех подотчетах: <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems>

Render2 отображает обработанный отчет, связанный с выполнением отчета, указанный в ExecutionInfo2 заголовке. Если снимок сессии не существует, этот метод выполнит отчёт (если все требования к учетным данным и параметрам выполнены), в результате чего создаётся новый снимок сессии. Если отчёт нужно переработать из-за изменения значений параметров, не связанных с запросом, снимок будет повторно обработан.

Если параметры выполнения настроены на кэш или снимок выполнения, вызов Render2 может использовать уже существующий снимок.

Если отчёт настроен на кэширование и значения параметров и учетные данные совпадают, кэшированная копия снимка может быть загружена вместо фактической обработки отчёта.

Если требования к учетным данным и параметрам не выполнены, этот метод выдаст ошибку.

Последующие вызовы могут Render2 использоваться для получения дополнительных страниц отчёта, если расширение рендеринга поддерживает указание нескольких страниц.

Ограничением метода Render является то, что выход нельзя передавать в поток, поэтому весь файл должен находиться в памяти.

Пожалуйста, см. раздел «Определение состояния выполнения » для обсуждения жизненного цикла выполнения, который включает описание шагов, необходимых для загрузки и отображения отчёта.

Применяется к