バージョン

定期的なアクティビティ (XamScheduler)

目的

このトピックはアクティビティの繰り返し動作について説明します。

前提条件

トピック 目的

このトピックでは、XamScheduler コントロール シリーズの概要を説明します。

このトピックでは、コントロールを ScheduleListDataSource を使用してデータ ソースへバインドする方法を説明します。

このトピックは Appointment アクティビティ型を説明します。

このトピックの構成

概要

アクティビティの定期的な予定は特定の定期的なパターンでアクティビティを繰り返す場合に使用します。

以下は、定期的なアクティビティを作成する方法です。

  1. アクティビティを作成してその件名、開始、および終了時間を設定します (定期的なルート アクティビティとなります)。

  2. DateRecurrence インスタンスを作成して以下を構成します。

    1. Frequency (日ごと、週ごと、月ごとなど)

    2. 繰り返す Count または Until (相互に排他的)

  3. ToICalendarString メソッドを使用して繰り返しの iCalendar 文字列形式を取得します。

    Note
    注:

    iCalendar 形式で定期的な予定の条件を作成するにはlink: このウェブサイトを使用することもできます。

  4. iCalendar 繰り返しの文字列形式をアクティビティの Recurrence プロパティに設定します。

  5. このアクティビティを ScheduleListDataSource の AppointmentItemsSource コレクション プロパティに追加します。

上記の手順によって DateRecurrence オブジェクトで指定した定期的なパターンに従って多数のアクティビティを作成します。

Note
注:

コントロールで作成した定期的なアクティビティはデータソースで使用できません。GetAppointmentsInRange メソッドを使用してのみ取得できます。データソースはルート アクティビティのみ含みます。

主なプロパティ

以下の表は、アクティビティの主な繰り返し動作に関連するプロパティとその使用目的を示します。

プロパティ 用途

この文字列プロパティは、定期的なルート アクティビティの定期的なパターンの取得および設定に使用されます。

この読み取り専用ブール プロパティは、アクティビティが定期的なルート アクティビティかどうかを決定します。

この読み取り専用 ActivityBase タイプ プロパティは、ルートの定期的なアクティビティを取得するために使用されます。アクティビティが繰り返しと関連付けされていない場合は null。

この読み取り専用文字列プロパティは、ルートの定期的なアクティビティの ID を取得するために使用されます。アクティビティが繰り返しと関連付けされていない場合は null。

コード例

以下のコードは、週ごとの定期的なアイテムのルールと 20 回の繰り返す定期的な予定を作成する例です。

C# の場合:

DateTime today = DateTime.Now.Date;

Appointment appointment1 = new Appointment();
appointment1.Subject = "Basketball";
appointment1.Location = "Basketball court";
appointment1.Start = new DateTime(today.Year, today.Month, today.Day, 19, 30, 0);
appointment1.End = new DateTime(today.Year, today.Month, today.Day, 20, 30, 0);

DateRecurrence dr = new DateRecurrence();
dr.Frequency = DateRecurrenceFrequency.Weekly;
dr.Count = 20;

appointment1.Recurrence = dr.ToICalendarString();

関連トピック

トピック 用途

このトピックは Appointment アクティビティ型を説明します。

このトピックは、XamScheduler コントロールのリソース概念について説明します。