ReportExecutionService.Render2 Metodo

Definizione

Spazio dei nomi:

ReportExecution2005

Assembly:

ReportExecution2005.dll

Elabora un report specifico e ne esegue il rendering nel formato specificato.

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()

Parametri

Format

String

Formato da utilizzare per il rendering del report. Questo argomento esegue il mapping a un'estensione per il rendering. Le estensioni supportate includono XML, NULL, CSV, IMAGE, PDF, HTML4.0, HTML3.2, MHTML, EXCEL e Word. È possibile ottenere un elenco di estensioni supportate chiamando il metodo ListRenderingExtensions().

DeviceInfo

String

Stringa XML che contiene il contenuto specifico del Format dispositivo richiesto dall'estensione di rendering specificata nel parametro. È necessario passare le impostazioni DeviceInfo come elementi interni di un elemento XML DeviceInfo. Per altre informazioni sulle impostazioni delle informazioni sul dispositivo per formati di output specifici, vedere Passaggio delle impostazioni delle informazioni sul dispositivo alle estensioni di rendering.

PaginationMode

PageCountMode

Modalità in base alla quale viene elaborato il report.

Extension

String

[out] Estensione file corrispondente al flusso di output.

MimeType

String

[out] Tipo MIME del report visualizzabile.

Encoding

String

[out] Codifica utilizzata quando il server di report esegue il rendering del contenuto del report.

Warnings

Warning[]

[out] Matrice di oggetti Warning che descrive gli avvisi generati durante l'elaborazione del report.

StreamIds

String[]

[out] Identificatori di flusso. Tali ID vengono passati al metodo RenderStream(String, String, String, String, String). È possibile utilizzarli per eseguire il rendering delle risorse esterne, ad esempio le immagini, associate a un determinato report.

Restituisce

Byte[]

Matrice Byte[] del report nel formato specificato.

Commenti

Nella tabella seguente vengono mostrate le informazioni sull'intestazione e sulle autorizzazioni relative a questa operazione.

Utilizzo intestazione SOAP	(In) TrustedUserHeaderValue (In) ExecutionHeaderValue (Out) ServerInfoHeaderValue
Autorizzazioni necessarie in modalità nativa	Nel report principale e in tutti i sottoreport: ReadProperties AND ExecuteAndView
Autorizzazioni necessarie per la modalità SharePoint	Nel report principale e in tutti i sottoreport: <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems>

Render2 esegue il rendering di un report elaborato associato all'esecuzione del report identificata nell'intestazione ExecutionInfo2 . Se non esiste uno snapshot di sessione, questo metodo eseguirà il report (se vengono soddisfatte tutte le credenziali e i requisiti dei parametri), causando la creazione di un nuovo snapshot di sessione. Se il report deve essere riprocessato perché i valori dei parametri non query sono stati modificati, lo snapshot verrà riprocessato.

Se le opzioni di esecuzione sono impostate su cache o snapshot di esecuzione, la chiamata a Render2 può usare uno snapshot esistente.

Se il report è impostato sulla cache e i valori dei parametri specificati e le credenziali corrispondono, la copia memorizzata nella cache dello snapshot può essere caricata anziché elaborare effettivamente il report.

Se i requisiti delle credenziali e dei parametri non sono soddisfatti, questo metodo restituirà un errore.

Le chiamate successive a Render2 possono essere usate per recuperare pagine aggiuntive del report se l'estensione di rendering supporta la specifica di più pagine.

Una limitazione del metodo Render è che l'output non può essere trasmesso, quindi l'intero file deve essere in memoria.

Vedere Identificazione dello stato di esecuzione per una discussione sul ciclo di vita dell'esecuzione, che include una descrizione dei passaggi necessari per caricare e eseguire il rendering di un report.