Conserver le Tag Helper d’état du composant dans ASP.NET Core

  • Article

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