このサイトで JavaScript が必要です。

バージョン

Is this content useful?

Thank you for your feedback!

Thank you for your feedback! You have rated this topic in the last 30 days.

バックエンドデータソースでフィールドをマップ

xamScheduleDataManager にデータを提供する一般的なシナリオは、スケジュールデータがデータベースまたはカスタムオブジェクトに保存される場合です。 ListScheduleDataConnector は、そのコレクションのスケジュールデータを提供する任意の IEnumerable オブジェクトに設定可能な複数の ItemsSource プロパティ（例、 AppointmentItemsSource）を公開します。ListScheduleDataConnector は、データソースを問い合わせるために LINQ を使用します。データソースが IQueryable である場合、LINQ を使用して、現在の表示に必要となるアクティビティのみを取得します。

作成する xamSchedule エンティティにデータソース　オブジェクトからプロパティをマップするには、関連する PropertyMappings コレクションを提供する必要があります（例、 AppointmentPropertyMappings）。これらは、データソース　オブジェクトでプロパティ名を指定する（DataObjectProperty を介して）PropertyMapping オブジェクト、対応する xamSchedule エンティティプロパティの名前（例、AppointmentProperty を使用して）、そしてデータソースオブジェクトのプロパティ値と xamSchedule プロパティ値の間で変換するために使用できるオプションのコンバーターのコレクションです。以下は、これらのマッピングプロパティを使用している例です。

注: プロパティのマッピングコレクションには、 UseDefaultMappings プロパティがあります。データソース　オブジェクトのプロパティ名が xamSchedule エンティティオブジェクトのプロパティ名と同じである場合、このプロパティは自動的にプロパティをマップするために True に設定できます。リフレクションは同じ名前でプロパティを検索するために使用され、一致するプロパティが自動的にマップされます。さらに、一部のプロパティの名前が同じでない場合、それらのプロパティの明示的なプロパティマッピングエントリをコレクションに追加できます。

XAML の場合:

<ig:ListScheduleDataConnector x:Name="scheduleDataConnector"
            ResourceItemsSource="{Binding CustomResources}"
            ResourceCalendarItemsSource="{Binding CustomCalendars}"
            AppointmentItemsSource="{Binding CustomAppointments}">
<ig:ListScheduleDataConnector.ResourcePropertyMappings>
        <ig:ResourcePropertyMappingCollection>
               <ig:ResourcePropertyMapping ResourceProperty="Id"
                        DataObjectProperty="MyId" />
                <ig:ResourcePropertyMapping ResourceProperty="Name"
                        DataObjectProperty="MyName" />
        </ig:ResourcePropertyMappingCollection>
    </ig:ListScheduleDataConnector.ResourcePropertyMappings>
<ig:ListScheduleDataConnector.ResourceCalendarPropertyMappings>
        <ig:ResourceCalendarPropertyMappingCollection>
                <ig:ResourceCalendarPropertyMapping
                        ResourceCalendarProperty="Id"
                        DataObjectProperty="MyId" />
                <ig:ResourceCalendarPropertyMapping
                        ResourceCalendarProperty="Name"
                        DataObjectProperty="MyName" />
                <ig:ResourceCalendarPropertyMapping
                        ResourceCalendarProperty="OwningResourceId"
                        DataObjectProperty="MyResourceId" />
        </ig:ResourceCalendarPropertyMappingCollection>
    </ig:ListScheduleDataConnector.ResourceCalendarPropertyMappings>
<ig:ListScheduleDataConnector.AppointmentPropertyMappings>
        <ig:AppointmentPropertyMappingCollection>
                <ig:AppointmentPropertyMapping
                        AppointmentProperty="Id"
                        DataObjectProperty="MyId" />
                <ig:AppointmentPropertyMapping
                        AppointmentProperty="Start"
                        DataObjectProperty="MyStart" />
                <ig:AppointmentPropertyMapping
                        AppointmentProperty="End"
                        DataObjectProperty="MyEnd" />
                <ig:AppointmentPropertyMapping
                        AppointmentProperty="OwningResourceId"
                        DataObjectProperty="MyOwnerId" />
                <ig:AppointmentPropertyMapping
                        AppointmentProperty="OwningCalendarId"
                        DataObjectProperty="MyCalendarId" />
                <ig:AppointmentPropertyMapping
                        AppointmentProperty="Subject"
                        DataObjectProperty="MySubject" />
                <ig:AppointmentPropertyMapping
                        AppointmentProperty="Description"
                        DataObjectProperty="MyDescription" />
        </ig:AppointmentPropertyMappingCollection>
    </ig:ListScheduleDataConnector.AppointmentPropertyMappings>
</ig:ListScheduleDataConnector>

Visual Basic の場合:

dataConnector.ResourcePropertyMappings =
    New ResourcePropertyMappingCollection()
dataConnector.ResourcePropertyMappings._
    Add(ResourceProperty.Id, "MyId")
dataConnector.ResourcePropertyMappings._
    Add(ResourceProperty.Name, "MyName")
dataConnector.ResourceCalendarPropertyMappings =_
    New ResourceCalendarPropertyMappingCollection()
dataConnector.ResourceCalendarPropertyMappings._
    Add(ResourceCalendarProperty.Id, "MyId")
dataConnector.ResourceCalendarPropertyMappings._
    Add(ResourceCalendarProperty.Name, "MyName")
dataConnector.ResourceCalendarPropertyMappings._
    Add(ResourceCalendarProperty.OwningResourceId, "MyResourceId")
dataConnector.AppointmentPropertyMappings =_
    New AppointmentPropertyMappingCollection()
dataConnector.AppointmentPropertyMappings._
    Add(AppointmentProperty.Id, "MyId")
dataConnector.AppointmentPropertyMappings._
    Add(AppointmentProperty.Start, "MyStart")
dataConnector.AppointmentPropertyMappings._
    Add(AppointmentProperty.[End], "MyEnd")
dataConnector.AppointmentPropertyMappings._
    Add(AppointmentProperty.OwningResourceId, "MyOwnerId")
dataConnector.AppointmentPropertyMappings._
    Add(AppointmentProperty.OwningCalendarId, "MyCalendarId")
dataConnector.AppointmentPropertyMappings._
    Add(AppointmentProperty.Subject, "MySubject")
dataConnector.AppointmentPropertyMappings._
    Add(AppointmentProperty.Description, "MyDescription")

C# の場合:

dataConnector.ResourcePropertyMappings =
    new ResourcePropertyMappingCollection();
dataConnector.ResourcePropertyMappings.Add(
    ResourceProperty.Id, "MyId");
dataConnector.ResourcePropertyMappings.Add(
    ResourceProperty.Name, "MyName");
dataConnector.ResourceCalendarPropertyMappings =
    new ResourceCalendarPropertyMappingCollection();
dataConnector.ResourceCalendarPropertyMappings.Add(
    ResourceCalendarProperty.Id, "MyId");
dataConnector.ResourceCalendarPropertyMappings.Add(
    ResourceCalendarProperty.Name, "MyName");
dataConnector.ResourceCalendarPropertyMappings.Add(
    ResourceCalendarProperty.OwningResourceId, "MyResourceId");
dataConnector.AppointmentPropertyMappings =
    new AppointmentPropertyMappingCollection();
dataConnector.AppointmentPropertyMappings.Add(
    AppointmentProperty.Id, "MyId");
dataConnector.AppointmentPropertyMappings.Add(
    AppointmentProperty.Start, "MyStart");
dataConnector.AppointmentPropertyMappings.Add(
    AppointmentProperty.End, "MyEnd");
dataConnector.AppointmentPropertyMappings.Add(
    AppointmentProperty.OwningResourceId, "MyOwnerId");
dataConnector.AppointmentPropertyMappings.Add(
    AppointmentProperty.OwningCalendarId, "MyCalendarId");
dataConnector.AppointmentPropertyMappings.Add(
    AppointmentProperty.Subject, "MySubject");
dataConnector.AppointmentPropertyMappings.Add(
    AppointmentProperty.Description, "MyDescription");

上記のサンプルコードでは、カスタムコレクション（CustomResources、CustomCalendars および CustomAppointments）は IEnumerable で、MyId や MyName などは、これらのコレクションが含むカスタムタイプのプロパティ名になります。

特定のプロパティマッピングは、XamSchedule が正しく機能するために必要となります。ID フィールドはそれらのひとつで、さらに ID 値は項目ソースの各オブジェクトに対して一意でなければなりません。

必要フィールド

リソース:

ID - String - ID 値はスケジュールデータコネクターによって作成および保存されません。したがって、含まれる値や長さが一意である限り制約はありません。

ResourceCalendar:

ID - String - ID 値はスケジュールデータコネクターによって作成および保存されません。したがって、含まれる値や長さが一意である限り制約はありません。
OwningResourceId - String - Resource の ID フィールドからの値は、リソースカレンダーをリソースにリンクするために使用されます。したがって、使用可能な長さは、Resource の ID フィールドで使用可能な長さに対応する必要があります。

Appointment、 Journal および Task に共通:

Id - String - 非バリアンスアクティビティでは、デフォルトで GUID 値が文字列として保存されるため、少なくとも 36 文字を使用できるようにする必要があります。バリアンスアクティビティでは、デフォルトで GUID、反復バージョン、さらに日付時間値が保存され、少なくとも 60 文字必要です。
Start - DateTime - このフィールドは null を使用できる DateTime フィールドにすることができます。
End - DateTime - このフィールドは null を使用できる DateTime フィールドにすることができます。
OwningResourceId - String - Resource の ID フィールドからの値は、リソースカレンダーをリソースにリンクするために使用されます。したがって、使用可能な長さは、Resource の ID フィールドで使用可能な長さに対応する必要があります。
StartTimeZoneId - String - 最大 40 文字まで使用できるようにする必要があります。
EndTimeZoneId - String - StartTimeZoneId と同じです。

以下のフィールドは、 ResourceCalendarItemsSource が提供される場合に限り必要とされます。

OwningCalendarId - String - ResourceCalendar の ID フィールドからの値は、リソースカレンダーをアクティビティにリンクするために使用されます。したがって、使用可能な長さは、ResourceCalendar の ID フィールドで使用可能な長さに対応する必要があります。

タイムゾーンニュートラルなアクティビティをサポートするには:

IsTimeZoneNeutral - Boolean - このフィールドは null にすることができます。

繰り返しアクティビティをサポートするには:

Recurrence - String - 繰り返しルールは、iCalendar RECUR 値形式で保存されます。このフィールドは、30 文字くらいから 100 文字をはるかに超えるテキスト値を持つことができる可変長フィールドにする必要があります。
MaxOccurrenceDateTime - DateTime - このフィールドは null を使用できる DateTime フィールドにすることができます。

繰り返しアクティビティのバリアンスをサポートするには:

RootActivityId - String - 少なくとも 36 文字を使用できるようにする必要があります。
OriginalOccurrenceStart - DateTime - このフィールドは null を使用できる DateTime フィールドにすることができます。
OriginalOccurrenceEnd - DateTime - このフィールドは null を使用できる DateTime フィールドにすることができます。
IsOccurrenceDeleted - bool
VariantProperties - Long
RecurrenceVersion - Integer

アラームをサポートするには:

ReminderEnabled - Boolean
ReminderInterval - TimeSpan
Reminder - String - このフィールドは、繰り返しではないアクティビティには不要ですが、繰り返しアクティビティのアラームをサポートするために必要です。このフィールドは可変長テキストフィールドである必要があります。

オプションフィールド

以下のリストは、オプションのフィールドに対する要件を定義します。これらのフィールドはオプションですが、スケジュール機能をより良くするためにマッピングを提供したい場合があります。

リソース:

Name - String
EmailAddress - String
Description - String
FirstDayOfWeek - .NET Nullable DayOfWeek 列挙体型または null を使用できる整数型。
DaysOfWeek - String - このフィールドは、ScheduleDaysOfWeek オブジェクトが XML としてシリアル化される可変長テキストフィールドである必要があります。
DaySettingsOverrides - String - このフィールドは、DaySettingsOverridesCollection が XML としてシリアル化される可変長テキストフィールドである必要があります。
IsVisible - Nullable Boolean
IsLocked - Boolean
UnmappedProperties - String - マッピングが提供されないフィールド値は、XML としてこのフィールドに保存されます。このフィールドは可変長テキストフィールドである必要があります。UnmappedProperties によって、不要なフィールドの定義を回避できますが、それらのフィールド値をデータソースに保存することはできます。

ResourceCalendar:

Name - String
Description - String
BaseColor - String
IsVisible - Nullable Boolean
UnmappedProperties - String - 上記の Resource の UnmappedProperties の説明を参照してください。

Appointment、 Journal および Task:

Subject - String
Location - String - 予定のみに適用されます。
Description - String
IsVisible - Nullable Boolean
IsLocked - Nullable Boolean
LastModifiedTime - DateTime
PercentComplete - Integer - タスクのみに適用されます。

ListScheduleDataConnector での LINQ の使用

LINQ はオンデマンドでアクティビティを取得するために使用されます。LINQ クエリが実行されるフィールドは、特定のタイプであることが求められます。

Start、 End、 MaxOccurrenceDateTime、 OriginalOccurrenceStart、 OriginalOccurrenceEnd - DateTime または null を使用できる DateTime である必要があります。
ReminderEnabled - Boolean または null を使用できる Boolean である必要があります。
ReminderInterval - TimeSpan 型である必要があります。

LINQ to SQL の使用

LINQ to SQL を使用する場合、以下のように sql テーブルで DateTime および TimeSpan 列を定義してください。

DateTime フィールド - datetime sql データ型の Date-time 範囲は、.NET DateTime データ型より小さくなります。Microsoft SQL 2008 バージョンでは、.NET DateTime データ型に一致するより大きい date-time 範囲が使用できる新しい datetime2 データ型があります。したがって、datetime2 は任意の date-time フィールドに使用される必要があります。SQL サーバーの古いバージョンでは、null を使用できる datetime を使用する必要があり、これによってデフォルト値（DateTime）を null として保存できます。
ReminderInterval - このフィールドは、TimeSpan フィールドにする必要があります。Microsoft SQL サーバーは、組み込みのタイムスパンデータ型を持たないので、bigint データ型を使用できます。ただし、LINQ to SQL スキーマでは、LINQ to SQL エンティティオブジェクトのプロパティ型を .NET TimeSpan に変更する必要があります。LINQ to SQL は、.NET TimeSpan 型と基本の SQL bigint 型で必要な変換を実行するための組み込みロジックを持ちます。

WPF | ヘルプトピック

バックエンドデータソースでフィールドをマップ

必要フィールド

オプションフィールド

ListScheduleDataConnector での LINQ の使用

LINQ to SQL の使用

関連トピック

WPF | ヘルプ トピック

バックエンド データ ソースでフィールドをマップ

必要フィールド

オプション フィールド

ListScheduleDataConnector での LINQ の使用

LINQ to SQL の使用

関連トピック

WPF | ヘルプトピック

バックエンドデータソースでフィールドをマップ

オプションフィールド