Sprache

ReportExecutionService.SetExecutionParameters Methode

Definition

Setzt und validiert Parameterwerte, die mit der aktuellen Berichtsausführung verbunden sind.

public:
 ReportExecution2005::ExecutionInfo ^ SetExecutionParameters(cli::array <ReportExecution2005::ParameterValue ^> ^ Parameters, System::String ^ ParameterLanguage);
public ReportExecution2005.ExecutionInfo SetExecutionParameters(ReportExecution2005.ParameterValue[] Parameters, string ParameterLanguage);
member this.SetExecutionParameters : ReportExecution2005.ParameterValue[] * string -> ReportExecution2005.ExecutionInfo
Public Function SetExecutionParameters (Parameters As ParameterValue(), ParameterLanguage As String) As ExecutionInfo

Parameter

Parameters
ParameterValue[]

Ein Array von ParameterValue-Objekten.

ParameterLanguage
String

Eine .NET Framework-Lokalkennung.

Gibt zurück

Ein Objekt, das ExecutionInfo die neue Ausführung enthält.

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>

Befindet sich ein Snapshot in der aktuellen Ausführung, wenn die Parameterwerte gesetzt werden, wird er gelöscht, wenn es sich nicht um eine Ausführung oder einen History-Snapshot handelt, was eine erneute Ausführung des Berichts erfordert. Für Ausführungs- oder Historien-Snapshots können Sie Werte für Nicht-Abfrageparameter angeben. Beachten Sie, dass der Berichtsserver keine Datenverarbeitung für Ausführungs- oder Verlaufssnapshots durchführt.

Wenn der von Ihnen angegebene Parameterwert einen falschen Typ hat, gibt die Methode einen Fehler zurück und der Parameter wird nicht geändert. Wenn der Parameterwert den richtigen Typ hat, aber kein gültiger Wert ist, tritt der Parameter in den Zustand MissingValidValue ein. In beiden Fällen führt der Versuch, den Bericht zu rendern, zu einem Fehler.

Wenn ParameterLanguage nicht angegeben ist, gilt die im HTTP-Header angegebene Accepts-Language Sprache. Wenn für den Accepts-Language HTTP-Header keine Sprache angegeben ist, wird die Standardsprache auf dem Berichtsserver verwendet.

Gilt für: