ReportExecutionService.SetExecutionParameters メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
現在のレポート実行に関連するパラメータ値を設定・検証します。
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.ExecutionInfoPublic Function SetExecutionParameters (Parameters As ParameterValue(), ParameterLanguage As String) As ExecutionInfoパラメーター
- Parameters
- ParameterValue[]
ParameterValue オブジェクトの配列。
- ParameterLanguage
- String
.NETフレームワークのローカレ識別子です。
返品
新しい実行を含む ExecutionInfo オブジェクト。
注釈
以下の表は、この操作のヘッダーおよび権限情報を示しています。
| SOAPヘッダーの使用 | (イン) TrustedUserHeaderValue (イン) ExecutionHeaderValue (アウト) ServerInfoHeaderValue |
| ネイティブモードの必要権限 | メインレポートおよびすべてのサブレポートでは、 ReadProperties AND ExecuteAndView |
| SharePointモードの必要権限 | メインレポートおよびすべてのサブレポートについて: <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems> |
パラメータ値が設定された時点で現在の実行中にスナップショットが存在する場合、それが実行や履歴スナップショットでなければクリアされ、レポートの再度実行が必要となります。 実行や履歴スナップショットについては、クエリ以外のパラメータの値を指定できます。 なお、レポートサーバーは実行や履歴スナップショットのデータ処理は行いません。
指定したパラメータ値の型が誤りの場合、メソッドはエラーを返し、パラメータは変更されません。 パラメータ値が正しい型であっても有効な値でない場合、パラメータは MissingValidValue 状態に入ります。 どちらの場合も、レポートを提出しようとするとエラーが生じます。
ParameterLanguageが指定されていない場合は、Accepts-LanguageHTTPヘッダーで指定された言語が使われます。
Accepts-Language HTTPヘッダーに言語が指定されていない場合、レポートサーバーのデフォルト言語が使用されます。