Liaison de données pour MVVM - .NET MAUI (2023)

Parcourir les exemples

Le modèle Model-View-ViewModel (MVVM) impose une séparation entre trois couches logicielles : l'interface utilisateur XAML (appelée la vue), les données sous-jacentes (appelées le modèle) et l'intermédiaire entre la vue et le modèle (appelé le ViewModel ). Les vues et les modèles de vue sont généralement connectés via des liaisons de données définies en XAML. Pouréquipe de liaisonUne vue est généralement une instance d'un modèle de vue.

MVVM simple

consisteExtension de balisage XAML, vous avez appris à définir une nouvelle déclaration d'espace de noms XML pour permettre aux fichiers XAML de référencer des classes dans d'autres assemblys. Dans l'exemple ci-dessous, l'extensionx : statiqueObtenir un jeton pour la date et l'heure actuelles d'une propriété statiqueDate Heure. MaintenantplutôtSystèmenom:

Dans cet exemple, la valeur est récupéréeheure de rendez-vousdéfini commeéquipe de liaisondans undisposition des agrafes.Lorsque vous réglez suréquipe de liaisonUn élément dont héritent tous les enfants de cet élément. Cela signifie que tous les enfants ontdisposition des agrafesle mêmeéquipe de liaisonet peut contenir des liaisons aux propriétés de cet objet :

Le problème, cependant, est que la date et l'heure sont définies une fois lors de la création et de l'initialisation de la page et ne changent jamais.

Une page XAML peut afficher une horloge qui affiche toujours l'heure actuelle, mais cela nécessite un code supplémentaire. Le modèle MVVM est un choix naturel pour les applications .NET MAUI lors de la liaison de données de propriété entre des objets visuels et des données sous-jacentes. Lorsque vous pensez à MVVM, Models et ViewModels sont des classes entièrement écrites en code. Une vue est généralement un fichier XAML qui fait référence aux propriétés définies dans le modèle de vue via la liaison de données. Dans MVVM, le modèle ignore le modèle de vue et le modèle de vue ignore la vue. Cependant, vous faites généralement correspondre les types affichés par le modèle d'affichage aux types associés à l'interface utilisateur.

L'exemple suivant montre un modèle d'affichage pour une montre qui contient une classe nomméeheure de rendez-vousMettre à jour chaque seconde :

à l'aide de System.ComponentModel, à l'aide de System.Runtime.CompilerServices, de l'espace de noms XamlSamples, de la classe ClockViewModel : INotifyPropertyChanged { événement public PropertyChangedEventHandler PropertyChanged ; DateHeure privée _dateTime ; (_dateTime!=Property_Changed); } } public ClockViewModel() { this.DateTime = DateTime.Now ; // Met à jour la propriété DateTime toutes les secondes. _timer = new Timer(new TimerCallback(s) => this.DateTime = DateTime.Now), null, TimeSpan.Zero, TimeSpan.FromSeconds(1)); } ~ClockViewModel() => _timer.Dispose(); public void OnPropertyChanged([CallerMemberName] string name = "") => PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(name));}

Viewmodel implémente généralement une interfaceINotifyPropertyChanged, qui permet aux classes de déclencher des événementschangé de propriétaireChaque fois qu'une de ses propriétés change. Le mécanisme de liaison de données dans .NET MAUI ajoute un gestionnaire pour celachangé de propriétaireafin que lorsqu'une propriété change, elle puisse être notifiée et la cible mise à jour avec la nouvelle valeur. Dans l'exemple de code précédent, la méthode gèreOnPropertyChangedDéclenchez un événement tout en déterminant automatiquement le nom source d'une propriété :heure de rendez-vous.

L'exemple suivant montre le code XAML utiliséModèle d'affichage de l'horloge:

Dans cet exempleModèle d'affichage de l'horlogeDéfini commeéquipe de liaisonétiquette d'élémentcontenu de la pageusage des biens. Les fichiers code-behind peuvent également créer des modèles d'affichage.

extensionficelerenregistrertextesa propriétéUne inscriptionformerheure de rendez-vouspropriété. La capture d'écran suivante montre le résultat :

Vous avez également accèsheure de rendez-vousAffichez les propriétés du modèle de vue en les séparant par des points :

MVVM interactif

MVVM est souvent utilisé avec une liaison de données bidirectionnelle pour les vues interactives basées sur le modèle de données sous-jacent.

L'exemple ci-dessous montreHslViewModelconversion uncouleurvaleurthonétaient,saturationAttendrebriller, puis encore :

de System.ComponentModel, de System.Runtime.CompilerServices, de XamlSamples, de HslViewModel : INotifyPropertyChanged μβάν PropertyChangedEventHandler PropertyChanged ; flotteur privé _hue, _saturation, _luminosity ; si! (valeur, _saturation, _luminosité) ; } } public float Saturation { obtenir => _saturation ; set { if (_saturation != value) Color = Color.FromHsla(_hue, value , _luminosity); } } public float Luminosité { get => _φωτεινότητα ; set { if (_luminosity!= value) Color = Color.FromHsla(_hue, _saturation, value); } } public Couleur Couleur { get => _color; set { if(_color != valeur) { _color = valeur ; _hue = _color.GetHue(); _saturation = _color.GetSaturation(); _luminosité = _color.GetLuminosity(); OnPropertyChanged("Teinte"); OnPropertyChanged("Saturation"); OnPropertyChanged("Luminosité"); OnPropertyChanged ); } } public void OnPropertyChanged([CallerMemberName] string name = "") => PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(name)); }

Dans cet exemplethonmodifier les propriétés,saturationAttendrebrillerentraîner des modificationscouleurPropriété et changementscouleurLa propriété modifie les trois autres propriétés. Ceci est similaire à une boucle infinie, sauf que le modèle de vue n'appelle pas l'événementchangé de propriétaire, sauf si la maison a été modifiée.

L'exemple XML suivant contientboîte de vueNéecouleurCette propriété est liée àcouleurafficher les propriétés du modèle et trois et troisUne inscriptionglissièreVues associéesthonCaractéristiques,saturationAttendrebriller:

par obligationUne inscriptionest le réglage par défautLoin.Il suffit d'afficher la valeur. La liaison par défaut pour chaqueglissièreEstrue à double sens.Ceci initialise leglissièredu modèle de visualisation. Lorsque le modèle d'affichage est créé, c'est le cascouleurla propriété a de la valeurcourse d'eau.changer unglissièreDéfinissez une nouvelle valeur pour la propriété sur le modèle de vue, puis calculez la nouvelle couleur :

Série

Parfois, une application doit aller au-delà de la propriété en demandant à l'utilisateur d'émettre des commandes qui affectent quelque chose dans le modèle d'affichage. Ces commandes sont généralement signalées en cliquant ou en touchant un bouton et sont généralement gérées dans le fichier de code derrière les gestionnaires d'événementsCliquez survanboutonL'événementennuyél'un desAppuyez sur ID de geste.

L'interface d'exécution de commande offre une alternative à l'implémentation de commande plus adaptée à l'architecture MVVM. Un modèle de vue peut contenir des commandes, qui sont des méthodes exécutées en réponse à des activités spécifiques dans la vue, telles queboutonCliquez sur. Des liaisons de données sont définies entre ces commandes etbouton.

Autorisation des liaisons de données entre unboutonvous êtes un modèle de projection, définiboutonDeux propriétés :

• Sérievas-y mecSystem.Windows.Input.ICCommandSystem.Windows.Input.ICCommand
• paramètres de commandevas-y mecBut

L'interfaceSérieest défini dans l'espace de nomssystem.windows.inputIl se compose de deux méthodes et d'un événement :

• exécuter non valide (paramètre d'objet)
• booléen CanExecute (paramètre d'objet)
• Utiliser EventHandler CanExecuteChanged

Les modèles de vue peuvent définir des propriétés de typeSérie.Vous pouvez ensuite lier ces propriétésSériela propriété de chacunboutoncomposant ou un autre composant, ou éventuellement une vue personnalisée qui implémente cette interface. Vous pouvez choisir de définirparamètres de commandepropriétés qui identifient un objet individuelbouton(ou d'autres éléments) à lier à cette propriété de modèle de vue. Interne, appelboutonIlmettre en œuvre, exécuterméthode à chaque clic de l'utilisateur,boutonje passe àmettre en œuvre, exécuterméthode sonoreparamètres de commande.

Ilpeut être effectuéeMéthodes etDes modifications peuvent être apportéesCet événement est utilisé dans les cas suivantsboutonLe robinet n'est peut-être pas valide pour le moment, doncboutonIl devrait s'éteindre. appel téléphoniqueboutonpeut être effectuéeLorsque la propriété est définie surSériepremier et chaque événementDes modifications peuvent être apportéesest activé. Imprudentpeut être effectuéeRENDEMENTInexacte, Ceboutons'éteint et ne génère pas d'appels versmettre en œuvre, exécuter.

tu peux l'utiliserSérieune sorte deSérieInclus dans .NET MAUI pour implémenter l'interfaceSérie.Ces deux classes définissent des constructeurs différents et unchangement actionnableUne méthode que le modèle d'affichage peut appeler pour appliquer l'objetSérieévénement déclencheurDes modifications peuvent être apportées.

L'exemple suivant montre le modèle d'affichage d'un clavier simple pour la saisie d'un numéro de téléphone :

en utilisant System.ComponentModel, en utilisant System.Runtime.CompilerServices, en utilisant System.Windows.Input, l'espace de noms XamlSamples, la classe KeypadViewModel : INotifyPropertyChanged{ événement public PropertyChangedEventHandler PropertyChanged ; ; char privé[] '*}_specialChars ICommand AddCharCommand { get; ensemble privé? } public ICommand DeleteCharCommand { obtenir ; ensemble privé? } chaîne publique InputString { obtenir => _inputString ; ensemble privé { if (_inputString != valeur) { _inputString = valeur ; OnPropertyChanged(); DisplayText = FormatText(_inputString); // Peut-être que le bouton de suppression devrait être activé/désactivé. ((commande)DeleteCharCommand).ChangeCanExecute(); } } } chaîne publique DisplayText { get => _displayText ; set privé { if (_displayText != value) { _displayText = value; OnPropertyChanged(); } } } public KeypadViewModel() { // Commande pour ajouter une clé à la chaîne d'entrée AddCharCommand = nouvelle commande((clé) => InputString += clé); // La commande supprime un caractère de la chaîne d'entrée si autorisé DeleteCharCommand = new Command( // La commande supprime un caractère de la chaîne d'entrée () => InputString = InputString .Substring(0 , InputString.Length - 1), // gérer CanExecute ici, retourner true s'il y a quelque chose à supprimer() => InputString.Length > 0); } string FormatText(string str) { bool hasNonNumbers = str. IndexOfAny(_specialChars) != -1; Format de chaîne = str; // formater la chaîne par type de données et longueur if (hasNonNumbers || str.Length < 4 || str.Length > 10) { // des caractères spéciaux sont présents, ou la chaîne est trop courte ou trop longue pour un formatage spécial // ne rien faire } sinon si (str.Length < 8) formaté = string.Format("{0}-{1}", str.Substring( 0, 3), str.Substring( 3)); sinon formaté = string.Format("({0}) {1}-{2}", str.Substring(0, 3), str.Substring(3, 3), str.Substring(6) ); format de retour ? } public void OnPropertyChanged([CallerMemberName] name string = "") => PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(name)); }

Dans cet exemplemettre en œuvre, exécuterMéthodes etpeut être effectuéeL'instruction for est définie comme une fonction lambda dans le constructeur. le modèle de projection supposeAjouter une commande de dessinla propriété est liéeSériePropriétés pour plusieurs boutons (ou tout autre contrôle d'interface de commande), chacun défini par un .paramètres de commandeCes boutons ajoutent des caractèreschaîne d'entréeattribut, qui est ensuite formaté comme un numéro de téléphonetexte d'affichagepropriété. Il existe également une deuxième catégorie de biens immobiliersSérieA été appelécommande pour supprimer des caractères.Ceci est lié au bouton de retour arrière, mais doit être désactivé s'il n'y a pas de caractères à supprimer.

L'exemple suivant montre le code XAML utilisé :KeyboardViewModel

    < Grid.RowDefinities>    < /Grid.RowDefinitions>                < Button Text="0" Command="{Binding AddCharCommand}" CommandParameter="0" Grid.Row="4" Grid.Column="1" /> 

Dans cet exempleSériepremière propriétéboutonC'est la même chose quecommande pour supprimer des caractères.Il a d'autres boutons qui lui sont associésAjouter une commande de dessinDansparamètres de commandeavec de l'éclat dedansbouton: