ReportExecutionService.Render2 Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Procesa un informe específico y lo muestra en el formato especificado.
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()Parámetros
- Format
- String
El formato en el que se debe presentar el informe. Este argumento se corresponde con una extensión de renderizado. Las extensiones soportadas incluyen XML, NULL, CSV, IMAGE, PDF, HTML4.0, HTML3.2, MHTML, Excel y Word. Se puede obtener una lista de extensiones soportadas llamando al ListRenderingExtensions() método.
- DeviceInfo
- String
Una cadena XML que contiene el contenido específico del dispositivo que requiere la extensión de renderizado especificada en el Format parámetro. La configuración de DeviceInfo debe pasarse como elementos internos de un elemento XML de DeviceInfo. Para más información sobre la configuración de información de dispositivos para formatos de salida específicos, consulte Pasar Configuración de Información de Dispositivo a Extensiones de Renderizado.
- PaginationMode
- PageCountMode
El modo en que se procesa el informe.
- Extension
- String
[fuera] La extensión del archivo correspondiente al flujo de salida.
- MimeType
- String
[fuera] El tipo MIME del informe renderizado.
- Encoding
- String
[fuera] La codificación utilizada cuando el servidor de informes muestra el contenido del informe.
- Warnings
- Warning[]
[fuera] Un conjunto de Warning objetos que describe cualquier advertencia que haya ocurrido durante el procesamiento de informes.
- StreamIds
- String[]
[fuera] Los identificadores de la corriente. Estos IDs se pasan al RenderStream(String, String, String, String, String) método. Puedes usarlos para renderizar los recursos externos (imágenes, etc.) asociados a un informe determinado.
Devoluciones
Un array de bytes[] del informe en el formato especificado.
Comentarios
La siguiente tabla muestra la información sobre cabeceras y permisos sobre esta operación.
| Uso de la cabecera SOAP | (En) TrustedUserHeaderValue (En) ExecutionHeaderValue (Fuera) ServerInfoHeaderValue |
| Permisos requeridos en modo nativo | En el informe principal y en todos los subinformes: ReadProperties Y ExecuteAndView |
| Permisos requeridos en el modo SharePoint | En el informe principal y en todos los subinformes: <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems> |
Render2 muestra un informe procesado asociado a la ejecución del informe identificado en la ExecutionInfo2 cabecera. Si no existe una instantánea de sesión, este método ejecutará el informe (si se cumplen todos los requisitos de credenciales y parámetros), lo que resultará en la creación de una nueva instantánea de sesión. Si el informe necesita ser reprocesado porque los valores de los parámetros no consultados han cambiado, la instantánea será reprocesada.
Si las opciones de ejecución están configuradas como caché o instantánea de ejecución, la llamada puede Render2 usar una instantánea existente.
Si el informe está configurado en caché y los valores de parámetros y credenciales proporcionados coinciden, la copia en caché de la instantánea puede cargarse en lugar de procesar realmente el informe.
Si no se cumplen los requisitos de credenciales y parámetros, este método devolverá un error.
Las llamadas posteriores pueden Render2 usarse para obtener páginas adicionales del informe si la extensión de renderizado permite especificar varias páginas.
Una limitación del método Render es que la salida no puede transmitirse, por lo que todo el archivo debe estar en memoria.
Por favor, consulte Identificación del Estado de Ejecución para una discusión sobre el ciclo de vida de la ejecución, que incluye una descripción de los pasos necesarios para cargar y generar un informe.