Come sappiamo, già dalla sua prima versione, ASP.NET MVC mette a nostra disposizione l'Html Helper ActionLink, tramite il quale possiamo generare link ad altre pagine del nostro sito specificando i nomi delle relative action e controller. Si tratta di una pratica che, oltre che comoda, risulta estremamente versatile nel momento in cui dovessimo modificare le route dell'applicazione, dato che tutti i link verrebbero ricalcolati automaticamente in base alle nuove regole. Un esempio di utilizzo è quello seguente, che rimanda alla action "About" del controller "HomeController":
@this.Html.ActionLink("About...", "about", "home")
Un limite di ActionLink, però, è che la realizzazione di link il cui contenuto non sia semplice testo, ma coinvolga ad esempio degli ulteriori tag, risulta tutt'altro che agevole. Per superare questo problema, possiamo realizzare un helper personalizzato, che ci consenta di specificare in maniera più libera il contenuto desiderato. Il nostro helper, invece che restituire un elemento di tipo string, scrive i tag Html direttamente nello stream di output e restituisce un'istanza di un oggetto DisposableActionLink.
public static DisposableActionLink TemplateActionLink( this HtmlHelper helper, string actionName, string controllerName, object routeValues, object htmlAttributes) { string targetUrl = UrlHelper.GenerateUrl(null, actionName, controllerName, new RouteValueDictionary(routeValues), helper.RouteCollection, helper.ViewContext.RequestContext, true); var tagBuilder = new TagBuilder("a"); tagBuilder.Attributes.Add("href", targetUrl); tagBuilder.MergeAttributes(new RouteValueDictionary(htmlAttributes)); helper.ViewContext.Writer.Write(tagBuilder.ToString(TagRenderMode.StartTag)); return new DisposableActionLink(helper.ViewContext); }
In particolare, l'Url di destinazione viene determinato grazie alla classe UrlHelper, mentre il vero e proprio tag Html è generato grazie a TagBuilder e mantenuto aperto. Eventualmente possiamo prevedere anche degli overload minimali, che consentano di utilizzare questo metodo senza dover necessariamente specificare tutti i parametri.
L'oggetto restituito non è altro che una classe che implementa IDisposable e che, all'esecuzione del metodo Dispose, si limita a scrivere sul medesimo stream di output il tag di chiusura:
public class DisposableActionLink : IDisposable { private TextWriter writer; public DisposableActionLink(ViewContext context) { this.writer = context.Writer; } public void Dispose() { this.writer.Write("</a>"); GC.SuppressFinalize(this); } }
Il vantaggio di questo approccio è che, a questo punto, possiamo generare dei link il cui contenuto sia totalmente personalizzabile, come nell'esempio seguente.
@using (this.Html.TemplateActionLink("about")) { <div> <img src="..." alt=".." /> Testo del link </div> }
Nonostante gli esempi di codice che abbiamo utilizzato siano basati sulla sintassi di Razor, questo metodo funziona con entrambi i ViewEngine previsti da ASP.NET MVC 3, ed è anche utilizzabile nelle versioni precedenti di questo framework. Attenzione però a non dimenticare di importare il namespace all'interno del quale è definito l'helper, pena un'eccezione a runtime.
@using MyHelperNamespace
<%@ Import namespace="MyHelperNamespace" %>
Commenti
Per inserire un commento, devi avere un account.
Fai il login e torna a questa pagina, oppure registrati alla nostra community.
Approfondimenti
Utilizzare l'operatore GroupBy come ultima istruzione di una query LINQ in Entity Framework
Usare le variabili per personalizzare gli stili CSS
Trasformare qualsiasi backend in un servizio GraphQL con Azure API Management
Configurare dependabot per aggiornare le dipendenze di terze parti con GitHub Actions
Migrare una service connection a workload identity federation in Azure DevOps
Disabilitare automaticamente un workflow di GitHub
Reactive form tipizzati con FormBuilder in Angular
Sfruttare i KeyedService in un'applicazione Blazor in .NET 8
Mascherare l'output di un valore all'interno dei log di un workflow di GitHub
Gestire domini wildcard in Azure Container Apps
Sfruttare lo streaming di una chiamata Http da Blazor
Eseguire query manipolando liste di tipi semplici con Entity Framework Core