教程：使用 MAUI 的 Atlas Device Sync for .NET

添加优先级属性

1. 在 RealmTodo 项目中，展开 Models 文件夹并打开 Item 类文件。

2. 添加以下公共属性：

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

   请注意，我们已将此属性设置为可为空，这将确保数据库中的现有项（没有 Priority 属性）继续可用。

在创建或修改项目时设置优先级

1. EditItemViewModel ViewModel 用于创建新事项和修改现有事项。创建或修改事项时，用户需要通过用户界面（和代码）来设置事项的优先级。

2. 添加一个 ObservableProperty 来保持优先级：

   [ObservableProperty]
   private int? priority;

   注意

   [ObservableProperty] 属性

   [ObservableProperty] 属性是 MVVM 工具包 提供的一项功能，用于简化数据绑定。

3. ApplyQueryAttributes 方法有点像此视图模型的“构造函数”，检查现有事项是否传递到此视图进行编辑。在这里，我们会捕获任何现有值，以便显示在视图中。

   如果正在编辑现有项，我们希望设置现有项的优先级：Priority = InitialItem.Priority;。

   同样，如果是创建新事项，则将默认优先级设置为 Medium（中）：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
         });
      }
   });

更新用户界面元素

1. 最后一项任务是添加设置和显示优先级所需的用户界面元素。

   首先，在 ItemsPage.xaml 中，我们将向 ListView 添加一个显示优先级的标签。在 ViewCell 中，添加一个显示项目优先级的标签：

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

2. 在 EditItemsPage.xaml 中，我们将添加两个 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>

运行和测试

此时，您可以再次运行应用程序。使用本教程前面创建的帐户登录。您将看到先前创建的一个列项。添加新列项，您将看到现在可以设置优先级。为优先级选择 High 并保存条目。

现在切换回浏览器中的 Atlas 数据页面，并刷新 Item 集合。您现在应该会看到添加了 priority 字段并将其设置为1 的新项目。您还会注意到，现有项目现在也有一个priority 字段，并且它设置为 null，如以下屏幕截图所示：

点击放大

更新订阅

在 RealmService.cs 文件中，我们定义两个灵活同步订阅。一个只显示当前用户创建的事项，另一个则显示所有用户的所有事项。

我们将添加一个新订阅，以显示当前用户的优先级为 0 或 1 的事项。

1. 在 RealmService 类的底部，向 SubscriptionType 枚举添加一个名为“MyHighPriority”的条目：

   public enum SubscriptionType
   {
      Mine,
      MyHighPriority,
      All,
   }

2. 向上滚动以找到 GetQueryForSubscriptionType 方法。我们在这里定义订阅。

   1. 复制第一个，其中subType == SubscriptionType.Mine ，立即将其粘贴到其下面的else if 块中。

   2. 将新条件设置为 subType == SubscriptionType.MyHighPriority。

   3. 修改此新订阅查询以插入一个 LINQ 查询，该查询不仅仍按 OwnerId 筛选，还按优先级值小于 2 进行筛选。

   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 方法中，将新订阅名称添加到 switch 语句中，如下所示：

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

4. 最后，打开ItemsViewModel 类并找到OnIsShowAllTasksChanged 方法。我们不变换用户界面以启用 3 个订阅，而是只将现有“mine”订阅替换为新订阅。更改SetSubscription 方法，使其类似如下所示：

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

运行和测试

再次运行应用程序。如果出现提示，请使用本教程前面创建的 帐户登录。

您应该会看到您创建的任何优先级为“高”(1) 或“严重”(0) 的项目。如果切换“Show all tasks”（显示所有任务）开关，应显示所有用户的所有任务。