Subscription.ScheduleRecurrence Property

スケジュールの循環情報を返します。値の設定も可能です。

名前空間: Microsoft.SqlServer.NotificationServices
アセンブリ: Microsoft.SqlServer.NotificationServices (microsoft.sqlserver.notificationservices.dll 内)

構文

'宣言
Public Property ScheduleRecurrence As String

public string ScheduleRecurrence { get; set; }

public:
virtual property String^ ScheduleRecurrence {
    String^ get () sealed;
    void set (String^ value) sealed;
}

/** @property */
public final String get_ScheduleRecurrence ()

/** @property */
public final void set_ScheduleRecurrence (String value)

public final function get ScheduleRecurrence () : String

public final function set ScheduleRecurrence (value : String)

プロパティ値

スケジュールの循環情報を表す String です。

解説

ScheduleStart プロパティも NULL の場合は ScheduleRecurrence プロパティに NULL を指定できますが、そうでない場合は ScheduleRecurrence プロパティに値を指定する必要があります。サブスクリプションにスケジュールを割り当てるには、このプロパティの両方に値を設定します。

ScheduleRecurrence プロパティには、ICalendar 循環ルール構文を使用して、ICalendar フォーマットで値を設定する必要があります。ScheduleRecurrence プロパティ値のアルファベットはすべて大文字にする必要があります。

定期的なルールが設定されていない (HasTimedRule プロパティが false の) サブスクリプションの場合、ScheduleStart プロパティと ScheduleRecurrence プロパティには値を設定できません。

ICalendar 循環のオプションを次の表に示します。

ICalendar 循環のオプション

FREQ=DAILY;

FREQ=WEEKLY;BYDAY=DaysOfWeekList;[BYMONTH=MonthsOfYearList;]

FREQ=MONTHLY;BYMONTHDAY=DaysOfMonthList;[BYMONTH=MonthsOfYearList;]

FREQ=YEARLY;BYMONTHDAY=DayOfMonth;BYMONTH=MonthOfYear;

スケジュールを設定するときに使用できるオプションを次に示します。

• DaysOfWeekList : [DayOfWeek | DayOfWeek,DaysOfWeekList]

  DayOfWeek : [MO | TU | WE | TH | FR | SA | SU]

• DaysOfMonthList : [DayOfMonth | DayOfMonth,DaysOfMonthList]

  DayOfMonth : [1 | 2 | 3 | ... | 30 | 31]

• MonthsOfYearList : [MonthOfYear | MonthOfYear,MonthsOfYearList]

  MonthOfYear : [1 | 2 | 3 | ... | 11 | 12]

たとえば、10 ～ 3 月の 1 日、11 日、15 日に循環スケジュールを設定する場合、ScheduleRecurrence プロパティの値には FREQ=MONTHLY;BYMONTHDAY=1,11,15;BYMONTH=1,2,3,10,11,12 を設定します。

使用例

ScheduleRecurrence プロパティを使用してサブスクリプションのスケジュール循環情報を設定する例を次に示します。

' Set the recurrence of the subscription.
testSubscription.ScheduleRecurrence = "FREQ=DAILY"
 
' Set the start date and time of the subscription.
Dim scheduleBuilder As New StringBuilder()
scheduleBuilder.AppendFormat( _
    "TZID={0}:{1}{2}{3}T{4}{5}{6}", "4", _
    DateTime.Now.Year.ToString("D4"), _
    DateTime.Now.Month.ToString("D2"), _
    DateTime.Now.Day.ToString("D2"), _
    DateTime.Now.Hour.ToString("D2"), _
    DateTime.Now.Minute.ToString("D2"), _
    DateTime.Now.Second.ToString("D2"))
testSubscription.ScheduleStart = scheduleBuilder.ToString()

// Set the recurrence of the subscription.
testSubscription.ScheduleRecurrence = "FREQ=DAILY";

// Set the start date and time of the subscription.
StringBuilder scheduleBuilder = new StringBuilder();
scheduleBuilder.AppendFormat("TZID={0}:{1}{2}{3}T{4}{5}{6}",
    "4",
    DateTime.Now.Year.ToString("D4"),
    DateTime.Now.Month.ToString("D2"),
    DateTime.Now.Day.ToString("D2"),
    DateTime.Now.Hour.ToString("D2"),
    DateTime.Now.Minute.ToString("D2"),
    DateTime.Now.Second.ToString("D2"));
testSubscription.ScheduleStart = scheduleBuilder.ToString();

スレッド セーフ

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

プラットフォーム

開発プラットフォーム

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

対象プラットフォーム

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

参照

関連項目

Subscription Class
Subscription Members
Microsoft.SqlServer.NotificationServices Namespace