Uygulama bildirim koleksiyonları

Bildirim Merkezi'nde uygulamanızın bildirimlerini düzenlemek için koleksiyonları kullanın. Koleksiyonlar, kullanıcıların bilgileri daha kolay bulmasına ve geliştiricilerin bildirimlerini daha iyi yönetmesine yardımcı olur.

Örneğin bir mesajlaşma uygulaması, bildirimleri sohbet grubuna göre ayırabilir. Her grup başlığı ("Comp Sci 160A Project Chat", "Direct Messages", "Lacrosse Team Chat") ayrı bir koleksiyondur. Bildirimler, hepsi aynı uygulamadan gelmiş olsalar bile ayrı bir uygulamadan gelmiş gibi gruplandırılır. Bildirimleri düzenlemenin daha ince bir yolu için bkz. Uygulama bildirimi üst bilgileri.

İki farklı Bildirim Grubuyla Koleksiyonu Örneği

Uyarı

Bu makaledeki kod örnekleri bildirim içeriği oluşturmak için Microsoft.Windows.AppNotifications ad alanını ve koleksiyon yönetimi için Windows.UI.Notifications ad alanını kullanır. Bu iki ad alanı aynı uygulamada birlikte kullanılabilir.

Uygulama bildirimleri hakkında daha fazla bilgi için bkz. Uygulama bildirimlerine genel bakış.

Koleksiyon oluşturma

Koleksiyon oluştururken, Bildirim Merkezi'nde koleksiyonun başlığının bir parçası olarak gösterilen bir görünen ad ve simge sağlayın. Koleksiyonlar, kullanıcı koleksiyon başlığına tıkladığında uygulamanızın doğru konumuna gidebilmesi için başlatma argümanı da gerektirir. SaveToastCollectionAsync çağrısı yaparak koleksiyonu oluşturun.

using Windows.UI.Notifications;

var collection = new ToastCollection(
    "MyToastCollection",
    "Work Email",
    "NavigateToWorkEmailInbox",
    new Uri("ms-appx:///Assets/workEmail.png"));

await ToastNotificationManager.GetDefault()
    .GetToastCollectionManager()
    .SaveToastCollectionAsync(collection);

Koleksiyona bildirim gönderme

Bildirim içeriğini oluşturmak için AppNotificationBuilder kullanın, ardından koleksiyona bağlı bir bildirim verici almak için GetToastNotifierForToastCollectionIdAsync fonksiyonunu çağırın.

using Microsoft.Windows.AppNotifications.Builder;
using Windows.UI.Notifications;
using Windows.Data.Xml.Dom;

// Build notification content with Windows App SDK
var payload = new AppNotificationBuilder()
    .AddText("Adam sent a message to the group")
    .BuildNotification()
    .Payload;

// Deliver to a collection using the WinRT API
var doc = new XmlDocument();
doc.LoadXml(payload);
var toast = new ToastNotification(doc);

var notifier = await ToastNotificationManager.GetDefault()
    .GetToastNotifierForToastCollectionIdAsync("MyToastCollection");
notifier.Show(toast);

Tüm koleksiyonları listeleme

FindAllToastCollectionsAsync çağrısı yaparak uygulamanız için oluşturulan tüm koleksiyonları alın.

var collectionManager = ToastNotificationManager.GetDefault().GetToastCollectionManager();
var collections = await collectionManager.FindAllToastCollectionsAsync();

Koleksiyonu güncelleştirme

Aynı kimliğe sahip yeni bir ToastCollection örneği oluşturup SaveToastCollectionAsync'i çağırarak koleksiyonu güncelleştirin.

var collectionManager = ToastNotificationManager.GetDefault().GetToastCollectionManager();

var updatedCollection = new ToastCollection(
    "MyToastCollection",
    "Updated Display Name",
    "UpdatedLaunchArgs",
    new Uri("ms-appx:///Assets/updatedPicture.png"));

await collectionManager.SaveToastCollectionAsync(updatedCollection);

Koleksiyonu kaldırma

Koleksiyon kimliğiyle RemoveToastCollectionAsync çağırarak bir koleksiyonu kaldırın. Koleksiyondaki tüm bildirimler de Bildirim Merkezi'nden kaldırılır.

var collectionManager = ToastNotificationManager.GetDefault().GetToastCollectionManager();
await collectionManager.RemoveToastCollectionAsync("MyToastCollection");

Koleksiyondaki bildirimleri kaldırma

Kaldır'ı çağırarak bir koleksiyondaki tek tek bildirimleri tanımlamak ve kaldırmak için Etiket ve Grup özelliklerini kullanın veya Temizle ile tüm bildirimleri aynı anda temizleyin.

var collectionHistory = await ToastNotificationManager.GetDefault()
    .GetHistoryForToastCollectionAsync("MyToastCollection");

// Remove a specific notification
collectionHistory.Remove(tag, group);

// Or clear all notifications in the collection
collectionHistory.Clear();

Ayrıca bakınız

  • Last updated on