ReportExecutionService.SetExecutionParameters メソッド
現在のレポート実行に関連するパラメーター値を設定し、検証します。
名前空間: ReportExecution2005
アセンブリ: ReportExecution2005 (ReportExecution2005.dll)
構文
'宣言
Public Function SetExecutionParameters ( _
Parameters As ParameterValue(), _
ParameterLanguage As String _
) As ExecutionInfo
'使用
Dim instance As ReportExecutionService
Dim Parameters As ParameterValue()
Dim ParameterLanguage As String
Dim returnValue As ExecutionInfo
returnValue = instance.SetExecutionParameters(Parameters, _
ParameterLanguage)
public ExecutionInfo SetExecutionParameters(
ParameterValue[] Parameters,
string ParameterLanguage
)
public:
ExecutionInfo^ SetExecutionParameters(
array<ParameterValue^>^ Parameters,
String^ ParameterLanguage
)
member SetExecutionParameters :
Parameters:ParameterValue[] *
ParameterLanguage:string -> ExecutionInfo
public function SetExecutionParameters(
Parameters : ParameterValue[],
ParameterLanguage : String
) : ExecutionInfo
パラメーター
- Parameters
型: array<ReportExecution2005.ParameterValue[]
ParameterValue オブジェクトの配列です。
- ParameterLanguage
型: System.String
.NET Framework のロケール識別子です。
戻り値
型: ReportExecution2005.ExecutionInfo
新しい実行を含む ExecutionInfo オブジェクトです。
説明
次の表に、この操作に関連するヘッダーおよび権限の情報を示します。
SOAP ヘッダーの使用方法 |
(In) ExecutionHeaderValue (Out) ServerInfoHeaderValue |
ネイティブ モードで必要な権限 |
メイン レポートおよびすべてのサブレポート: ReadProperties および ExecuteAndView |
SharePoint モードで必要な権限 |
メイン レポートおよびすべてのサブレポート: ViewListItems |
パラメーター値が設定された場合、現在の実行にスナップショットが存在すると、そのスナップショットは実行スナップショットまたは履歴スナップショットでない限り消去されます。その結果、レポートの再実行が必要になります。 実行スナップショットまたは履歴スナップショットの場合は、非クエリ パラメーターの値を指定できます。 実行スナップショットまたは履歴スナップショットでは、レポート サーバーはデータ処理を実行しないことに注意してください。
指定したパラメーター値の型が正しくない場合、メソッドはエラーを返し、パラメーターは変更されません。 パラメーター値の型は正しくても値が有効でない場合は、パラメーターが MissingValidValue 状態になります。 どちらの場合も、レポートを表示しようとするとエラーが発生します。
ParameterLanguage が指定されていない場合は、Accepts-Language HTTP ヘッダーで指定された言語。Accepts-Language HTTP ヘッダーの言語が指定されていない場合は、レポート サーバーの既定の言語が使用されます。