ReportExecutionService.SetExecutionParameters メソッド

定義

名前空間:

ReportExecution2005

アセンブリ:

ReportExecution2005.dll

現在のレポート実行に関連するパラメーター値を設定し、検証します。

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

パラメーター

Parameters

ParameterValue[]

ParameterValue オブジェクトの配列。

ParameterLanguage

String

.NET Framework のロケール識別子です。

戻り値

ExecutionInfo

新しい実行を含む ExecutionInfo オブジェクトです。

注釈

次の表に、この操作に関連するヘッダーおよび権限の情報を示します。

SOAP ヘッダーの使用方法	(In) TrustedUserHeaderValue (In) ExecutionHeaderValue (Out) ServerInfoHeaderValue
ネイティブ モードで必要なアクセス許可	メイン レポートおよびすべてのサブレポート: ReadProperties および ExecuteAndView
SharePoint モードで必要なアクセス許可	メイン レポートおよびすべてのサブレポート: <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems>

パラメーター値が設定された場合、現在の実行にスナップショットが存在すると、そのスナップショットは実行スナップショットまたは履歴スナップショットでない限り消去されます。その結果、レポートの再実行が必要になります。 実行スナップショットまたは履歴スナップショットの場合は、非クエリ パラメーターの値を指定できます。 実行スナップショットまたは履歴スナップショットでは、レポート サーバーはデータ処理を実行しないことに注意してください。

指定したパラメーター値の型が正しくない場合、メソッドはエラーを返し、パラメーターは変更されません。 パラメーター値の型は正しくても値が有効でない場合は、パラメーターが MissingValidValue 状態になります。 どちらの場合も、レポートを表示しようとするとエラーが発生します。

ParameterLanguage が指定されていない場合は、Accepts-Language HTTP ヘッダーで指定された言語が使用されます。 Accepts-Language HTTP ヘッダーに言語が指定されていない場合は、レポート サーバーの既定の言語が使用されます。