ReportExecutionService.Render2 Metode

Definisi

Ruang nama:

ReportExecution2005

Rakitan:

ReportExecution2005.dll

Memproses laporan tertentu dan merendernya dalam format yang ditentukan.

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

Parameter

Format

String

Format untuk merender laporan. Argumen ini memetakan ke ekstensi penyajian. Ekstensi yang didukung termasuk XML, NULL, CSV, IMAGE, PDF, HTML4.0, HTML3.2, MHTML, EXCEL, dan Word. Daftar ekstensi yang didukung dapat diperoleh dengan memanggil ListRenderingExtensions() metode .

DeviceInfo

String

String XML yang berisi konten khusus perangkat yang diperlukan oleh ekstensi penyajian yang ditentukan dalam Format parameter . Pengaturan DeviceInfo harus diteruskan sebagai elemen internal elemen XML DeviceInfo. Untuk informasi selengkapnya tentang pengaturan informasi perangkat untuk format output tertentu, lihat Meneruskan Pengaturan Informasi Perangkat ke Ekstensi Rendering.

PaginationMode

PageCountMode

Mode di mana laporan diproses.

Extension

String

[out] Ekstensi file yang sesuai dengan aliran output.

MimeType

String

[out] Jenis MIME dari laporan yang dirender.

Encoding

String

[out] Pengodean yang digunakan saat server laporan merender konten laporan.

Warnings

Warning[]

[out] Array Warning objek yang menjelaskan peringatan apa pun yang terjadi selama pemrosesan laporan.

StreamIds

String[]

[out] Pengidentifikasi aliran. ID ini diteruskan ke RenderStream(String, String, String, String, String) metode . Anda dapat menggunakannya untuk merender sumber daya eksternal (gambar, dll.) yang terkait dengan laporan tertentu.

Mengembalikan

Byte[]

Array Byte[] laporan dalam format yang ditentukan.

Keterangan

Tabel di bawah ini memperlihatkan informasi header dan izin pada operasi ini.

Penggunaan Header SOAP	(Dalam) TrustedUserHeaderValue (Dalam) ExecutionHeaderValue (Keluar) ServerInfoHeaderValue
Izin Yang Diperlukan Mode Asli	Pada laporan utama dan semua sublaporan: ReadProperties AND ExecuteAndView
Izin Yang Diperlukan Mode SharePoint	Pada laporan utama dan semua sublaporan: <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems>

Render2 merender laporan yang diproses yang terkait dengan eksekusi laporan yang diidentifikasi di ExecutionInfo2 header . Jika tidak ada rekam jepret sesi, metode ini akan menjalankan laporan (jika semua persyaratan kredensial dan parameter terpenuhi), sehingga rekam jepret sesi baru dibuat. Jika laporan perlu diolah ulang karena nilai parameter non-kueri telah berubah, rekam jepret akan diolah ulang.

Jika opsi eksekusi diatur ke rekam jepret cache atau eksekusi, panggilan ke Render2 dapat menggunakan rekam jepret yang ada.

Jika laporan diatur ke cache dan nilai parameter dan kredensial yang disediakan cocok, salinan rekam jepret yang di-cache dapat dimuat alih-alih benar-benar memproses laporan.

Jika persyaratan kredensial dan parameter tidak terpenuhi, metode ini akan mengembalikan kesalahan.

Panggilan berikutnya untuk Render2 dapat digunakan untuk mengambil halaman tambahan laporan jika ekstensi penyajian mendukung penentuan beberapa halaman.

Batasan metode Render adalah bahwa output tidak dapat dialirkan, sehingga seluruh file harus dalam memori.

Silakan lihat Mengidentifikasi Status Eksekusi untuk diskusi siklus hidup eksekusi, yang mencakup deskripsi langkah-langkah yang diperlukan untuk memuat dan merender laporan.