ReportExecutionService.Render2 Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Обрабатывает указанный отчет и готовит его к просмотру в заданном формате.
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[] отчета в указанном формате.
Комментарии
В следующей таблице показаны сведения о заголовках и разрешениях для этой операции.
| Использование заголовка 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 заключается в том, что выходные данные не могут быть потоковой передачей, поэтому весь файл должен находиться в памяти.
Сведения о жизненном цикле выполнения, в том числе описание шагов, необходимых для загрузки и подготовки отчета, см. в разделе Определение состояния выполнения .