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

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

MimeType

String

[out] Тип MIME готового к просмотру отчета.

Encoding

String

[out] Кодировка, которая используется сервером отчетов при подготовке содержимого отчета к просмотру.

Warnings

Warning[]

[out] Массив объектов Warning, который описывает все предупреждения, полученные во время обработки отчета.

StreamIds

String[]

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

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

Byte[]

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

Комментарии

В следующей таблице показаны сведения о заголовках и разрешениях для этой операции.

Использование заголовка SOAP	(In) TrustedUserHeaderValue (In) ExecutionHeaderValue (Out) ServerInfoHeaderValue
Необходимые разрешения в собственном режиме	На main отчет и все вложенные отчеты: ReadProperties ANDExecuteAndView
Необходимые разрешения в режиме Интеграции с SharePoint	На main отчет и все вложенные отчеты:<xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems>

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

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

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

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

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

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

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