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
Miglioramenti agli screen reader e al contrasto in Angular
Implementare il throttling in ASP.NET Core
Effettuare chiamate con versioning da Blazor ad ASP.NET Core
Accesso sicuro ai secrets attraverso i file in Azure Container Apps
Evitare la script injection nelle GitHub Actions
Evitare (o ridurre) il repo-jacking sulle GitHub Actions
Eseguire attività con Azure Container Jobs
Load test di ASP.NET Core con k6
Utilizzare domini personalizzati gestiti automaticamente con Azure Container Apps
Le novità di Angular: i miglioramenti alla CLI
C# 12: Cosa c'è di nuovo e interessante
Come migrare da una form non tipizzata a una form tipizzata in Angular
I più letti di oggi
- annunciato #netstandard 2.1. .NET Core lo supporterà a partire da #netcore3, così come le prossime versione di #xamarin, #mono e #unity.il supporto per #netfx 4.8, invece, non ci sarà. https://aspit.co/bq2
- Steel Style CheckBox per Silverlight 4.0
- Supporto ai tipi DateOnly e TimeOnly in Entity Framework Core
- Speciale Windows Store app: costruire app con WinRT per Windows 8