ReportExecutionService.LoadReportDefinition(Byte[], Warning[]) 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.
Erstellt eine Berichtsausführung aus einer vom Client bereitgestellten Berichtsdefinition.
public:
ReportExecution2005::ExecutionInfo ^ LoadReportDefinition(cli::array <System::Byte> ^ Definition, [Runtime::InteropServices::Out] cli::array <ReportExecution2005::Warning ^> ^ % warnings);public ReportExecution2005.ExecutionInfo LoadReportDefinition (byte[] Definition, out ReportExecution2005.Warning[] warnings);member this.LoadReportDefinition : byte[] * Warning[] -> ReportExecution2005.ExecutionInfoPublic Function LoadReportDefinition (Definition As Byte(), ByRef warnings As Warning()) As ExecutionInfoParameter
- Definition
- Byte[]
Ein Bytedatenstrom, der die Berichtsdefinitionssprache (Report Definition Language, RDL) für den Bericht enthält.
- warnings
- Warning[]
Eine Auflistung von Warning-Objekten, die Warnungen enthält, die möglicherweise während der Berichtsveröffentlichung aufgetreten sind.
Gibt zurück
Ein ExecutionInfo-Objekt, das Informationen für die Berichtsausführung enthält.
Beispiele
Ein Beispiel finden Sie unter Render .
Hinweise
In der folgenden Tabelle werden Header- und Berechtigungsinformationen zu diesem Vorgang dargestellt.
| SOAP-Headerverwendung | (In) TrustedUserHeaderValue (Out) ExecutionHeaderValue (Out) ServerInfoHeaderValue |
| Erforderliche Berechtigungen im einheitlichen Modus | ReadProperties für alle Unterberichte AND ExecuteReportDefinition (System) |
| Erforderliche Berechtigungen im SharePoint-Modus | <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems> in allen Unterberichten UND <xref:Microsoft.SharePoint.SPBasePermissions.UseRemoteAPIs> |
Diese Methode sollte vor dem Aufrufen der Render Methode für einen Bericht aufgerufen werden.
Die zurückgegebene Berichtsausführung muss verarbeitet werden, bevor sie gerendert wird. Eine neue Ausführung wird erstellt, und die ExecutionInfo wird mit einem neuen ExecutionID Wert zurückgegeben.
Berichte, die mit der LoadReportDefinition -Methode instanziiert werden, sind temporär. Sie werden nicht im Berichtsservernamespace dargestellt und verworfen, wenn die Serversitzung abläuft.
Berichte, die mit der LoadReportDefinition -Methode instanziiert wurden, sind nicht sicherungsfähig und dürfen nicht für andere Benutzer freigegeben werden. Die Person, mit LoadReportDefinition der die Ausführung erstellt wurde, ist der einzige Benutzer, der auf sie zugreifen kann.
Unterberichte und Datenquellenverweise mit relativen Pfaden werden mit dieser Methode nicht unterstützt. Es können jedoch absolute Pfade zu Katalogelementen verwendet werden.