ToastNotification Classe

Definizione

Spazio dei nomi:

Windows.UI.Notifications

Definisce il contenuto, i metadati e gli eventi associati e l'ora di scadenza di una notifica di tipo avviso popup.

public ref class ToastNotification sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.Notifications.IToastNotificationFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ToastNotification final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.Notifications.IToastNotificationFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ToastNotification

function ToastNotification(content)

Public NotInheritable Class ToastNotification

Ereditarietà

Object Platform::Object IInspectable ToastNotification

Attributi

ActivatableAttribute ContractVersionAttribute ThreadingAttribute MarshalingBehaviorAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

Per indicazioni su come implementare notifiche di tipo avviso popup nell'app, vedere Inviare una notifica di avviso popup locale dalle app C#.

Linee guida per la gestione dell'attivazione delle app per le notifiche di tipo avviso popup:

• Le applicazioni UWP devono usare OnActivated per gestire le attivazioni di tipo avviso popup.
• A partire da WinRT Build 19041, le app in pacchetto (incluse le app in pacchetto con posizione esterna) sono in grado di usare ToastNotificationActionTrigger per gestire le attivazioni per altri dettagli.
• Le app desktop possono usare l'attivazione COM seguendo Desktop - Invia avviso popup locale.
• Se nessuna delle opzioni di attivazione è adatta all'applicazione, seguire l'esempio in questo documento per l'uso corretto dei gestori eventi.

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
1607	14393	NotificationMirroring
1607	14393	RemoteId
1703	15063	Dati
1703	15063	Priorità
1903	18362	ExpiresOnReboot

Costruttori

ToastNotification(XmlDocument)

Crea e inizializza una nuova istanza di ToastNotification.

Proprietà

Content	Ottiene il codice XML che definisce la notifica di tipo avviso popup corrente.
Data	Ottiene o imposta informazioni aggiuntive sullo stato della notifica di tipo avviso popup.
ExpirationTime	Ottiene o imposta l'ora dopo la quale non deve essere visualizzata una notifica di tipo avviso popup.
ExpiresOnReboot	Indica se la notifica di tipo avviso popup rimarrà nel Centro notifiche dopo un riavvio.
Group	Ottiene o imposta l'identificatore del gruppo per la notifica.
NotificationMirroring	Ottiene o imposta un valore che specifica se è consentito il mirroring delle notifiche.
Priority	Ottiene o imposta la priorità della notifica di tipo avviso popup.
RemoteId	Ottiene o imposta un ID remoto per la notifica che consente al sistema di correlare questa notifica con un'altra generata in un altro dispositivo.
SuppressPopup	Ottiene o imposta se l'interfaccia utente popup di un avviso popup viene visualizzata nella schermata dell'utente.
Tag	Ottiene o imposta l'identificatore univoco di questa notifica all'interno del gruppo di notifica.

Eventi

Activated	Si verifica quando l'utente attiva una notifica di tipo avviso popup tramite un clic o un tocco. App che eseguono la sottoscrizione a questo evento.
Dismissed	Si verifica quando una notifica di tipo avviso popup lascia la schermata, scaduta o ignorata in modo esplicito dall'utente. App che eseguono la sottoscrizione a questo evento.
Failed	Si verifica quando un errore viene causato quando Windows tenta di generare una notifica di tipo avviso popup. App che eseguono la sottoscrizione a questo evento.

Vedi anche

• Esempio di notifiche di tipo avviso popup
• Esempio di invio notifiche di tipo avviso popup da app desktop
• Xml Schema di tipo avviso popup
• Riquadri e notifiche
• Avvio rapido: Invio di una notifica di tipo avviso popup
• Avvio rapido: Invio di una notifica push popup
• Avvio rapido: Invio di una notifica popup dal desktop
• Linee guida ed elenco di controllo per le notifiche popup
• Come gestire l'attivazione da una notifica di tipo avviso popup
• Come acconsentire esplicitamente alle notifiche di tipo avviso popup
• Come pianificare una notifica di tipo avviso popup
• Come abilitare le notifiche di tipo avviso popup sul desktop tramite un AppUserModelID
• Catalogo di modelli di tipo avviso popup
• Opzioni audio di tipo avviso popup