BstHelpers.Web

Web/MVC companion to BstHelpers: extensions for HttpContext, ClaimsPrincipal, ISession, SelectList, IHtmlContent/TagBuilder, ViewContext, plus a <custom-tag> tag helper.

Tag helper

Register the tag helper assembly in _ViewImports.cshtml:

@addTagHelper *, BstHelpers.Web

Renders any HTML element from a single tag, forwarding attributes:

<custom-tag asp-tag="div" class="card"></custom-tag>
<custom-tag asp-tag="@(isLink ? "a" : "span")" href="@Model.Url" class="btn">@Model.Label</custom-tag>

Empty/whitespace attributes are skipped. If asp-tag is null, nothing is rendered.

Usage

HttpContext

var baseUrl = HttpContext.GetRequestBaseUrl(); // "https://example.com"

ClaimsPrincipal (User)

User.GetUserId();          // ClaimTypes.NameIdentifier as string
User.GetUserIdInt();       // same, parsed to int (0 if missing)
User.GetName();            // ClaimTypes.GivenName
User.IsLogged();           // authenticated AND user id != 0
User.ClaimValue("custom"); // arbitrary claim type

Session (ISession)

JSON-serialized object storage (Newtonsoft, ReferenceLoopHandling.Ignore):

HttpContext.Session.SetObject("cart", cart);
var cart = HttpContext.Session.GetObject<Cart>("cart");

SelectList

// From IEnumerable
var list = items.NewSelectList(dataValueField: "Id", dataTextField: "Name", selectedValue: 5);

// From IQueryable<T> (materializes async)
var list = await dbContext.Categories
    .Select(c => new { c.Id, c.Name })
    .NewSelectList("Id", "Name");

// Add a placeholder as the first option
list = list.SetPlaceholder("-- choose --");
list = list.SetPlaceholder(new HtmlString("<em>none</em>"));

HTML / TagBuilder rendering

IHtmlContent content = ...;
string html = content.ToHtmlString();

var tag = new TagBuilder("a");
tag.Attributes["href"] = "/x";
tag.InnerHtml.Append("link");
string html = tag.GetHtml();

ViewContext (in Razor views)

@using BstHelpers.Web.Extensions

@{
    var action = ViewContext.GetAction();
    var controller = ViewContext.GetController();
}