Conserver le Tag Helper d’état du composant dans ASP.NET Core
L’assistant de balise d’état du composant persistant enregistre l’état des composants non routables Razor affichés dans une page ou un affichage d’une application Razor Pages ou MVC.
Prérequis
Suivez les instructions fournies dans la section Utiliser des composants non routables dans des pages ou des affichages de l’article Intégrer des composants Razor ASP.NET Core dans des applications ASP.NET Core.
Suivez l’aide de la section Configuration pour :
État persistant pour les composants prédéfinis
Pour conserver l’état des composants prérendus, utilisez le Tag Helper d’état du composant (source de référence). Ajoutez la balise de l’assistant de balise, <persist-component-state />
, à l’intérieur de la balise de fermeture </body>
de la disposition dans une application qui affiche au préalable les composants.
Remarque
Les liens de documentation vers la source de référence .NET chargent généralement la branche par défaut du référentiel, qui représente le développement actuel pour la prochaine version de .NET. Pour sélectionner une balise pour une version spécifique, utilisez la liste déroulante Échanger les branches ou les balises. Pour plus d’informations, consultez Comment sélectionner une balise de version du code source ASP.NET Core (dotnet/AspNetCore.Docs #26205).
En Pages/Shared/_Layout.cshtml
pour les composants intégrés qui sont soit affichés au préalable par WebAssembly (WebAssemblyPrerendered
), soit affichés au préalable par le serveur (ServerPrerendered
) :
<body>
...
<persist-component-state />
</body>
Déterminez l’état à conserver à l’aide du service PersistentComponentState. PersistentComponentState.RegisterOnPersisting
enregistre un rappel pour conserver l’état du composant avant que l’application ne soit suspendue. L’état est récupéré lorsque l’application reprend.
Pour plus d’informations et d’exemples, consultez Afficher au préalable des composants Razor ASP.NET Core.
Pour conserver l’état des composants prérendus, utilisez le Tag Helper d’état du composant (source de référence). Ajoutez la balise du Tag Helper, <persist-component-state />
, à la balise fermante </body>
de la page _Host
dans une application qui affiche au préalable les composants.
Notes
Les liens de documentation vers la source de référence .NET chargent généralement la branche par défaut du référentiel, qui représente le développement actuel pour la prochaine version de .NET. Pour sélectionner une balise pour une version spécifique, utilisez la liste déroulante Échanger les branches ou les balises. Pour plus d’informations, consultez Comment sélectionner une balise de version du code source ASP.NET Core (dotnet/AspNetCore.Docs #26205).
Dans Pages/_Host.cshtml
des applications Blazor qui sont prérendues WebAssembly (WebAssemblyPrerendered
) dans une application Blazor WebAssembly hébergée ou ServerPrerendered
dans une application Blazor Server :
<body>
...
<persist-component-state />
</body>
Déterminez l’état à conserver à l’aide du service PersistentComponentState. PersistentComponentState.RegisterOnPersisting
enregistre un rappel pour conserver l’état du composant avant que l’application ne soit suspendue. L’état est récupéré lorsque l’application reprend.
Pour plus d’informations et d’exemples, consultez Prérendu et intégration des composants Razor ASP.NET Core.
Ressources supplémentaires
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour