ReportExecutionService.Render2 Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Verarbeitet einen bestimmten Bericht und stellt ihn im angegebenen Format dar.
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
Das Format, in dem der Bericht erstellt wird. Dieses Argument wird auf eine Rendering-Erweiterung abgebildet. Unterstützte Erweiterungen sind XML, NULL, CSV, IMAGE, PDF, HTML4.0, HTML3.2, MHTML, EXCEL und Word. Eine Liste unterstützter Erweiterungen kann durch Aufruf der Methode ListRenderingExtensions() erhalten werden.
- DeviceInfo
- String
Eine XML-Zeichenkette, die den gerätespezifischen Inhalt enthält, der von der im Parameter Format angegebenen Rendering-Erweiterung gefordert wird. DeviceInfo-Einstellungen müssen als interne Elemente eines DeviceInfo XML-Elements übermittelt werden. Weitere Informationen zu Geräteinformationseinstellungen für bestimmte Ausgabeformate finden Sie unter Passing Device Information Settings to Rendering Extensions.
- PaginationMode
- PageCountMode
Die Art und Weise, wie der Bericht verarbeitet wird.
- Extension
- String
[aus] Die Dateiendung, die dem Ausgabestrom entspricht.
- MimeType
- String
[aus] Der MIME-Typ des gerenderten Berichts.
- Encoding
- String
[aus] Die Codierung, die beim Berichtsserver verwendet wird, stellt den Inhalt des Berichts dar.
- Warnings
- Warning[]
[aus] Ein Array von Warning Objekten, das alle Warnungen beschreibt, die während der Berichtsbearbeitung aufgetreten sind.
- StreamIds
- String[]
[aus] Die Stream-Identifikatoren. Diese IDs werden an die Methode RenderStream(String, String, String, String, String) weitergegeben. Sie können sie nutzen, um die externen Ressourcen (Bilder usw.) zu rendern, die einem bestimmten Bericht zugeordnet sind.
Gibt zurück
Ein Byte[]- Array des Berichts im angegebenen Format.
Hinweise
Die untenstehende Tabelle zeigt Header- und Berechtigungsinformationen zu dieser Operation.
| Verwendung von SOAP-Headern | (In) TrustedUserHeaderValue (In) ExecutionHeaderValue (Aus) ServerInfoHeaderValue |
| Erforderliche Berechtigungen im nativen Modus | Im Hauptbericht und allen Unterberichten: ReadProperties UND ExecuteAndView |
| Erforderliche Berechtigungen im SharePoint-Modus | Zum Hauptbericht und allen Unterberichten: <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems> |
Render2 stellt einen bearbeiteten Bericht dar, der mit der Berichtsausführung im Header ExecutionInfo2 identifiziert ist. Wenn kein Sitzungssnapshot vorhanden ist, führt diese Methode den Bericht aus (wenn alle Anforderungen an Zugangsdaten und Parameter erfüllt sind), wodurch ein neuer Sessionssnapshot erstellt wird. Wenn der Bericht neu bearbeitet werden muss, weil sich die Werte der Nicht-Abfrageparameter geändert haben, wird der Snapshot erneut bearbeitet.
Wenn die Ausführungsoptionen auf Cache oder Ausführungssnapshot gesetzt sind, kann der Aufruf einen Render2 bestehenden Snapshot verwenden.
Wenn der Bericht auf Cache gesetzt ist und die angegebenen Parameterwerte sowie Zugangsdaten übereinstimmen, kann die zwischengespeicherte Kopie des Snapshots geladen werden, anstatt den Bericht tatsächlich zu verarbeiten.
Wenn die Anforderungen an Zugangsdaten und Parameter nicht erfüllt sind, liefert diese Methode einen Fehler.
Nachfolgende Aufrufe können Render2 verwendet werden, um zusätzliche Seiten des Berichts abzurufen, wenn die Rendering-Erweiterung die Angabe mehrerer Seiten unterstützt.
Eine Einschränkung der Render-Methode ist, dass die Ausgabe nicht gestreamt werden kann, sodass die gesamte Datei im Speicher sein muss.
Bitte siehe Identifying Execution State für eine Diskussion des Ausführungslebenszyklus, die eine Beschreibung der notwendigen Schritte zum Laden und Erstellen eines Berichts enthält.