ReportExecutionService.Render2 Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Processa um relatório específico e o renderiza no 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
O formato no qual um relatório deve ser renderizado. Esse argumento é mapeado para uma extensão de renderização. As extensões com suporte incluem XML, NULL, CSV, IMAGE, PDF, HTML 4.0, HTML3.2, MHTML, EXCEL e Word. Uma lista de extensões com suporte pode ser obtida chamando o método ListRenderingExtensions().
- DeviceInfo
- String
Uma cadeia de caracteres XML que contém o conteúdo específico do dispositivo exigido pela extensão de renderização especificada no Format parâmetro . As configurações de DeviceInfo devem ser transmitidas como elementos internos de um elemento XML DeviceInfo. Para obter mais informações sobre as configurações de informações do dispositivo para formatos de saída específicos, consulte Passando configurações de informações do dispositivo para extensões de renderização.
- PaginationMode
- PageCountMode
O modo pelo qual o relatório é processado.
- Extension
- String
[out] A extensão de arquivo que corresponde ao fluxo de saída.
- MimeType
- String
[out] O tipo MIME do relatório renderizado.
- Encoding
- String
[out] A codificação usada quando o servidor de relatório renderiza o conteúdo do relatório.
- Warnings
- Warning[]
[out] Uma matriz de objetos Warning que descreve todos os avisos ocorridos durante o processamento do relatório.
- StreamIds
- String[]
[out] Os identificadores de fluxo. Essas IDs são transmitidas para o método RenderStream(String, String, String, String, String). É possível usá-las para renderizar os recursos externos (imagens, etc.) associados a um determinado relatório.
Retornos
Uma matriz Byte[] do relatório no formato especificado.
Comentários
A tabela a seguir mostra o cabeçalho e as informações de permissão sobre esta operação.
| Uso do cabeçalho SOAP | (In) TrustedUserHeaderValue (In) ExecutionHeaderValue (Out) ServerInfoHeaderValue |
| Permissões necessárias do modo nativo | No relatório main e todos os sub-relatórios: ReadProperties ANDExecuteAndView |
| Permissões necessárias do modo do SharePoint | No relatório main e todos os sub-relatórios:<xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems> |
Render2 renderiza um relatório processado associado à execução do relatório identificada no ExecutionInfo2 cabeçalho. Se não houver instantâneo de sessão, esse método executará o relatório (se todos os requisitos de credenciais e parâmetros forem atendidos), resultando na criação de uma nova sessão instantâneo. Se o relatório precisar ser reprocessado porque os valores de parâmetro não consulta foram alterados, o instantâneo será reprocessado.
Se as opções de execução estiverem definidas como cache ou instantâneo de execução, a chamada para Render2 poderá usar um instantâneo existente.
Se o relatório estiver definido como cache e os valores de parâmetro e as credenciais fornecidos corresponderem, a cópia armazenada em cache do instantâneo poderá ser carregada em vez de realmente processar o relatório.
Se os requisitos de credencial e parâmetro não forem atendidos, esse método retornará um erro.
Chamadas subsequentes a Render2 podem ser usadas para buscar páginas adicionais do relatório se a extensão de renderização der suporte à especificação de várias páginas.
Uma limitação do método Render é que a saída não pode ser transmitida, portanto, todo o arquivo deve estar na memória.
Consulte Identificando o estado de execução para uma discussão sobre o ciclo de vida de execução, que inclui uma descrição das etapas necessárias para carregar e renderizar um relatório.