ReportingService2005.SetExecutionOptions メソッド

定義

名前空間:

ReportService2005

アセンブリ:

ReportService2005.dll

指定したレポートの実行オプションおよび関連付けられた実行プロパティを設定します。

public:
 void SetExecutionOptions(System::String ^ Report, ReportService2005::ExecutionSettingEnum ExecutionSetting, ReportService2005::ScheduleDefinitionOrReference ^ Item);

public void SetExecutionOptions (string Report, ReportService2005.ExecutionSettingEnum ExecutionSetting, ReportService2005.ScheduleDefinitionOrReference Item);

member this.SetExecutionOptions : string * ReportService2005.ExecutionSettingEnum * ReportService2005.ScheduleDefinitionOrReference -> unit

Public Sub SetExecutionOptions (Report As String, ExecutionSetting As ExecutionSettingEnum, Item As ScheduleDefinitionOrReference)

パラメーター

Report

String

レポートの完全なパス名です。

ExecutionSetting

ExecutionSettingEnum

レポートをいつ実行するかを表す ExecutionSettingEnum 値の 1 つです。 値は Live と Snapshot のいずれかにできます。

Item

ScheduleDefinitionOrReference

スケジュールに従ってレポートを実行するためにレポート サーバーが使用する、スケジュール定義または共有スケジュール (ScheduleDefinitionOrReference オブジェクト) です。

例

次のコード例をコンパイルするには、Reporting Services の WSDL を参照し、特定の名前空間をインポートする必要があります。 詳細については、「 コード例のコンパイルと実行」を参照してください。 次のコード例では、SetExecutionOptions メソッドを使用して、Company Sales レポートをスケジュールに従ったスナップショットとして実行するようにオプションを設定します。

using System;  
using System.Web.Services.Protocols;  

class Sample  
{  
   public static void Main()  
   {  
      ReportingService2005 rs = new ReportingService2005();  
      rs.Credentials = System.Net.CredentialCache.DefaultCredentials;  

      ScheduleDefinition definition = new ScheduleDefinition();  

      // Create the schedule definition.  
      definition.StartDateTime = new DateTime( 2003, 2, 22, 10, 15, 0 );  
      MinuteRecurrence recurrence = new MinuteRecurrence();  
      recurrence.MinutesInterval = 60;  
      definition.Item = recurrence;  

      // Apply execution settings  
      try  
      {  
         rs.SetExecutionOptions("/SampleReports/Company Sales", ExecutionSettingEnum.Snapshot, definition);  
      }  

      catch (SoapException ex)  
      {  
         Console.WriteLine(ex.Detail.OuterXml);  
      }  
   }  
}  

注釈

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

SOAP ヘッダー	(In) BatchHeaderValue (Out) ServerInfoHeaderValue
必要なアクセス許可	UpdatePolicy

Item パラメーターは、ExecutionSetting パラメーターが Snapshot の場合にのみ有効です。 Item に null を指定した場合は、ExecutionSetting には Nothing (Visual Basic では Live) を指定します。 共有スケジュールを使用する場合、Item の値に、既存の共有スケジュールを参照する ScheduleReference オブジェクトを設定します。 一意のスケジュールを定義する場合は、Item の値に、一意のスケジュールを定義する ScheduleDefinition オブジェクトを設定します。 レポートの実行オプションが共有スケジュールに基づいており、その共有スケジュールが削除された場合は、スケジュールが個々のレポートに関連付けられます。

ExecutionSetting の値を Live から Snapshot に変更すると、レポートがキャッシュから削除されます。