Table of Contents

Link / @Link Object in Dynamic Code

Basically you can always link around to other pages, websites or views using normal <a href="...">text</a> html. And often you just want to add some parameters to the current Url like ?id=27 - but the behavior of this can be very different depending on the Dnn settings. The Link object helps you handle this.

Note: Dnn often has a problem with links, because depending on what page you are on, the bbehavior is a bit different. This is especially important on the home page. Use @Link.To(...) to make sure everything works no matter what.

Discover More in the Razor Tutorials

We have an rich series of Razor tutorials. You should really check them out 👍.


How it works

The Link-object is always available in all Razor-templates. Internally it uses the Dnn API to get the correct url.

Use @Link.To() for Linking Pages, Parameters and APIs

👉 See Link.To(...) / ...) Method in Dynamic Code

Use @Link.Image(...) for Images with Resizing and more 🆕

👉 See Link.Image(...) / Method in Dynamic Code

Use @Link.Base() for JavaScript SPA modules

If you have a SPA on your page you will often need to set the proper base tag. To get it, use Link.Base().

👉 See Link.Base() / Method in Dynamic Code

In rare cases you may get a link you don't expect. To help you figure out what happens, you can do this:

Link.SetDebug(true);
var x = Link.Image("my.jpg", Settings.Images.Content, factor: 0.5);
Link.SetDebug(false);

This will add a lot more debug information in the Insights, so you should be able to figure out what happened.

Notes and Clarifications

The Link-Object is of type ILinkService.

You should find some code examples in this demo App

History

  1. Introduced in 2sxc 8.4
  2. Enhanced in 2sxc 9.5.1 with Base() and with parameter pageId on Link.To
  3. Link.To was enhanced with api in v12.02
  4. Link.Image was created in v12.04