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 representa 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
Formato en el que se representará el informe. Este argumento se corresponde con una extensión de representación. Entre las extensiones admitidas se incluyen XML, NULL, CSV, IMAGE, PDF, HTML4.0, HTML3.2, MHTML, EXCEL y Word. La lista de extensiones admitidas se puede obtener llamando al método ListRenderingExtensions().
- DeviceInfo
- String
Cadena XML que contiene el contenido específico del dispositivo que requiere la extensión de representación especificada en el Format parámetro . Las opciones de DeviceInfo se deben pasar como elementos internos de un elemento XML DeviceInfo. Para obtener más información sobre la configuración de la información del dispositivo para formatos de salida específicos, vea Pasar la configuración de información del dispositivo a extensiones de representación.
- PaginationMode
- PageCountMode
Modo con el que se procesa el informe.
- Extension
- String
[salida] Extensión de archivo que corresponde al flujo de salida.
- MimeType
- String
[salida] Tipo MIME del informe representado.
- Encoding
- String
[salida] Codificación utilizada cuando el servidor de informes representa el contenido del informe.
- Warnings
- Warning[]
[out] Matriz de objetos Warning que describen las advertencias ocurridas durante el procesamiento del informe.
- StreamIds
- String[]
[salida] Identificadores del flujo. Estos identificadores se pasan al método RenderStream(String, String, String, String, String). Puede utilizarlos para representar los recursos externos (imágenes, etc.) que están asociados a un informe determinado.
Devoluciones
Matriz Byte[] del informe en el formato especificado.
Comentarios
En la siguiente tabla se muestra la información de encabezado y de permisos de esta operación.
| Uso de encabezados SOAP | (In) TrustedUserHeaderValue (In) ExecutionHeaderValue (Out) ServerInfoHeaderValue |
| Permisos necesarios en modo nativo | En el informe principal y en todos los subinformes: ReadProperties AND ExecuteAndView |
| Permisos necesarios en modo de SharePoint | En el informe principal y en todos los subinformes: <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems> |
Render2 representa un informe procesado asociado a la ejecución del informe identificada en el ExecutionInfo2 encabezado . Si no existe ninguna instantánea de sesión, este método ejecutará el informe (si se cumplen todos los requisitos de credenciales y parámetros), lo que dará lugar a que se cree una nueva instantánea de sesión. Si es necesario volver a procesar el informe porque los valores de parámetros que no son de consulta han cambiado, se volverá a procesar la instantánea.
Si las opciones de ejecución se establecen en caché o instantánea de ejecución, la llamada a Render2 puede usar una instantánea existente.
Si el informe se establece en caché y los valores de parámetro proporcionados y las credenciales coinciden, la copia almacenada en caché de la instantánea se puede cargar 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 a Render2 se pueden usar para capturar páginas adicionales del informe si la extensión de representación admite la especificación de varias páginas.
Una limitación del método Render es que no se puede transmitir la salida, por lo que todo el archivo debe estar en memoria.
Consulte Identificación del estado de ejecución para obtener una explicación del ciclo de vida de ejecución, que incluye una descripción de los pasos necesarios para cargar y representar un informe.