次の方法で共有

HostedEventProvider.StartTime Property

  • [アーティクル]

ホストされるイベント プロバイダの各呼び出し時刻の計算に使用される時刻を取得または設定します。

名前空間: Microsoft.SqlServer.Management.Nmo
アセンブリ: Microsoft.SqlServer.Smo (microsoft.sqlserver.smo.dll 内)

構文

'宣言
Public Property StartTime As DateTime

public DateTime StartTime { get; set; }

public:
property DateTime StartTime {
    DateTime get ();
    void set (DateTime value);
}

/** @property */
public DateTime get_StartTime ()

/** @property */
public void set_StartTime (DateTime value)

public function get StartTime () : DateTime

public function set StartTime (value : DateTime)

プロパティ値

イベント プロバイダの開始時刻を示す DateTime オブジェクトです。

解説

StartTime 値は、UTC で指定する必要があります。

StartTime 値を指定しない場合、Notification Services によるイベント プロバイダの初回の実行は、インスタンスの起動時、またはイベント プロバイダの有効化時です。

StartTime 値を指定する場合、プロバイダは Notification Services によって次のように実行されます。

  • Notification Services は、StartTime 値から始まる 24 時間分の呼び出し時刻を計算します。

  • Notification Services は、計算した呼び出し時刻のうちの次の機会を初回として、イベント プロバイダを呼び出します。

開始時刻の値を削除するには、値を DateTime.MinValue に設定します。アプリケーションを更新すると、この値が Notification Services によって使用され、StartTime が NULL に設定されます。

次の表は、さまざまな StartTime と Interval の値を設定した呼び出しスケジュール例を示します。

スケジュール

値と説明

毎時 30 分

StartTime 時刻の値は 1:30 (または任意の時間の 30 分) です。

Interval 値は PT1H です。

初回のイベント プロバイダは、次の 30 分 (0:30、1:30、2:30 など、23:30 までのいずれか) に実行されます。

1:00 から 3 時間ごと

StartTime 時刻の値は 1:00 です。

Interval 値は PT3H です。

初回のイベント プロバイダは、次の 3 時間間隔 (1:00、4:00、7:00、10:00、13:00、16:00、19:00、22:00 のいずれか) に実行されます。

12:00 から 6 時間ごと

StartTime 時刻の値は 12:00 です。

Interval 値は PT6H です。

初回のイベント プロバイダは、次の 6 時間間隔 (0:00、6:00、12:00、18:00 のいずれか) に実行されます。

毎日 4:00

StartTime 時刻の値は 4:00 です。

Interval 値は PT24H です。

イベント プロバイダは、起動時刻に関係なく、毎日 4:00 に実行されます。

使用例

次の例は、開始時刻を持たない、ホストされるイベント プロバイダを定義する方法を示しています。このイベント プロバイダは、イベント プロバイダのホストが起動するとすぐに実行されます。

// Define a hosted event provider and set properties.
HostedEventProvider flightEventProvider = new HostedEventProvider();
flightEventProvider.Parent = myApplication;
flightEventProvider.Name = "FlightEP";
flightEventProvider.StartTime = DateTime.MinValue;
flightEventProvider.Timeout = new TimeSpan(0, 5, 0);
flightEventProvider.ClassName = "FileSystemWatcherProvider";
flightEventProvider.AssemblyName = "";
flightEventProvider.SystemName = notificationServicesHost;

' Define a hosted event provider and set properties.
Dim flightEventProvider As HostedEventProvider = _
    New HostedEventProvider()
flightEventProvider.Parent = myApplication
flightEventProvider.Name = "FlightEP"
flightEventProvider.StartTime = DateTime.MinValue
flightEventProvider.Timeout = New TimeSpan(0, 5, 0)
flightEventProvider.ClassName = "FileSystemWatcherProvider"
flightEventProvider.AssemblyName = ""
flightEventProvider.SystemName = notificationServicesHost

スレッド セーフ

この型の public static (Microsoft Visual Basic では共有 ) メンバは、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

開発プラットフォーム

サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。

対象プラットフォーム

サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。

参照

関連項目

HostedEventProvider Class
HostedEventProvider Members
Microsoft.SqlServer.Management.Nmo Namespace

その他の技術情報

ホストされるイベント プロバイダの定義
HostedProvider/Schedule の StartTime 要素 (ADF)