チュートリアル: を使用したAtlas Device Sync .NETforMaui

優先順位プロパティを追加する

1. RealmTodoプロジェクトで、 Modelsフォルダを展開し、 Itemクラスファイルを開きます。

2. 次のパブリック プロパティを追加します。

   [MapTo("priority")]
   public int? Priority { get; set; }

   このプロパティを null 可能として設定していることに注意してください。これにより、データベース内の既存のアイテム（ 優先順位 プロパティがない場合）は引き続き利用できます。

アイテムの作成または変更時の優先順位の設定

1. EditItemViewModel ViewModel は、新しいアイテムの作成と既存のアイテムの変更に使用されます。 アイテムを作成または変更する際、ユーザーは UI（および コード）を使用してアイテムの優先順位を設定する必要があります。

2. 優先順位を保持するために ObservableProperty を追加します。

   [ObservableProperty]
   private int? priority;

   注意

   [ObservableProperty] 属性

   [ObservableProperty]属性は MVVM ツールキー によって提供される機能です データ バインディングを簡素化するため。

3. ApplyQueryAttributesメソッドは、このビューモデルのビット「コンストラクター」として機能し、既存のアイテムが編集用にこのビューに渡されているかどうかを確認します。 ここでは、既存の値をキャプチャし、ビューに表示します。

   既存のアイテムを編集する場合は、既存のアイテムの優先順位をPriority = InitialItem.Priority;に設定します。

   同様に、新しいアイテムを作成する場合は、デフォルトの優先順位を「中」に設定します: Priority = 2; 。

   完了すると、このメソッドは次のようになります。

   public void ApplyQueryAttributes(IDictionary<string, object> query)
   {
         if (query.Count > 0 && query["item"] != null) // we're editing an Item
         {
            InitialItem = query["item"] as Item;
            Summary = InitialItem.Summary;
            Priority = InitialItem.Priority;
            PageHeader = $"Modify Item {InitialItem.Id}";
         }
         else // we're creating a new item
         {
            Summary = "";
            Priority = 2;
            PageHeader = "Create a New Item";
         }
   }

4. 最後に、 SaveItem()メソッドで、優先順位の値を永続化します。 管理対象オブジェクトを作成または変更しているため、変更はrealm.WriteAsync呼び出しでラップされます。

   既存のアイテムには既存のオブジェクトにInitialItem.Priorityを設定し、新しいアイテムにはAdd()呼び出しで プロパティを設定します。 完了したWriteAsyncブロックは次のようになります。

   await realm.WriteAsync(() =>
   {
      if (InitialItem != null) // editing an item
      {
         InitialItem.Summary = Summary;
         InitialItem.Priority = Priority;
      }
      else // creating a new item
      {
         realm.Add(new Item()
         {
               OwnerId = RealmService.CurrentUser.Id,
               Summary = summary,
               Priority = Priority
         });
      }
   });

UI 要素を更新する

1. 最後のタスクは、優先順位の設定と表示に必要な UI 要素を追加することです。

   まず、 ItemsPage.xamlで、優先順位を示す ListView にラベルを追加します。 ViewCll 内で、アイテムの優先順位を表示するための ラベル を追加します。

   <Label Text="{Binding Priority}"
      HorizontalOptions="Center"
      VerticalOptions="Center"/>

2. EditItemsPage.xamlでは、新しいアイテムに設定する優先順位を選択できるようにするピッカーと、ピッカーのラベルの 2 つの UI 要素を追加します。 概要を設定するためのEntry要素を見つけ、その下に次の要素を追加します。

   <Label Text="Priority:"/>
   <Picker x:Name="newItemPriority" SelectedIndex="{Binding Priority}">
      <Picker.Items>
            <x:String>Severe</x:String>
            <x:String>High</x:String>
            <x:String>Medium</x:String>
            <x:String>Low</x:String>
      </Picker.Items>
   </Picker>

およびテストの実行

この時点で、アプリケーションを再度実行できます。 このチュートリアルの前半で作成したアカウントを使用してログインします。 過去に作成した 1 つのアイテムが表示されます。 新しいアイテムを追加すると、優先順位を設定できるようになります。 優先順位をHighに選択し、アイテムを保存します。

ブラウザで Atlas データページに切り替え、 Itemコレクションを更新します。 これでpriorityフィールドが追加され、 1に設定された新しいアイテムが表示されます。 また、次のスクリーンショットに示すように、既存のアイテムにpriorityフィールドも追加され、 nullに設定されていることにも注意してください。

クリックして拡大します

サブスクライブを更新する

RealmService.csファイルでは、2 つの Flexible Sync サブスクリプションを定義します。 一方には現在のユーザーが作成したアイテムのみが表示され、もう一方のドキュメントにはすべてのユーザーが作成したアイテムがすべて表示されます。

現在のユーザーの優先順位が 0 または 1 のアイテムを表示する新しいサブスクライブを追加します。

1. RealmServiceクラスの下部に、「MyHighPriority」というエントリをSubscriptionType列挙型に追加します。

   public enum SubscriptionType
   {
      Mine,
      MyHighPriority,
      All,
   }

2. GetQueryForSubscriptionTypeメソッドを見つけるには、上にスクロールします。 ここで、サブスクリプションを定義します。

   1. 最初の 1 つであるsubType == SubscriptionType.Mineをコピーし、それをすぐ下にあるelse ifブロックに貼り付けます。

   2. 新しい条件をsubType == SubscriptionType.MyHighPriorityに設定します。

   3. この新しいサブスクリプション クエリを変更して、OwnerId と 2 未満の 優先順位 値でフィルタリングする LINQ クエリを挿入します。

   4.新しいクエリの名前を "myHighPri" に変更します。 コードは次のようになります。

   if (subType == SubscriptionType.Mine)
   {
         query = realm.All<Item>()
            .Where(i => i.OwnerId == CurrentUser.Id)
            .Where(i => i.Priority < 2);
         queryName = "mine";
   }
   else if (subType == SubscriptionType.MyHighPriority)
   {
         query = realm.All<Item>()
           .Where(i => i.OwnerId == CurrentUser.Id &&
                  i.Priority < 2);
         queryName = "myHighPri";
   }
   else if (subType == SubscriptionType.All)
   {
         query = realm.All<Item>();
         queryName = "all";
   }

3. すぐ上のGetCurrentSubscriptionTypeメソッドで、スイッチ ステートメントに新しいサブスクリプション名を追加し、次のようにします。

   return activeSubscription.Name switch
   {
       "all" => SubscriptionType.All,
       "mine" => SubscriptionType.Mine,
       "myHighPri" => SubscriptionType.MyHighPriority,
       _ => throw new InvalidOperationException("Unknown subscription type")
   };

4. 最後に、 ItemsViewModelクラスを開き、 OnIsShowAllTasksChangedメソッドを見つけます。 UI を変更して 3 つのサブスクリプションを有効にするのではなく、既存の "base" サブスクリプションを新しいサブスクリプションに置き換えます。 SetSubscriptionメソッドを次のように変更します。

   await RealmService.SetSubscription(realm, value
      ? SubscriptionType.All
      : SubscriptionType.MyHighPriority);

およびテストの実行

アプリケーションを再度実行します。 入力を求められた場合は、このチュートリアルの前半で作成したアカウントを使用してログインします。

優先順位が「高」（1）または「重要」（0）を持つ、これまで作成したアイテムが表示されることが予想されます。 「すべてのタスクを表示」スイッチを切り替えると、すべてのユーザーによるすべてのタスクが表示されます。