Server Utilities Migration

This sample demonstrates the ServerShim that provides Web Forms-compatible Server.MapPath(), Server.HtmlEncode(), Server.UrlEncode(), and ResolveUrl() in Blazor.

1. Server.MapPath()

In Web Forms, Server.MapPath("~/uploads") resolved a virtual path to a physical path. The BWFC shim provides the same API backed by IWebHostEnvironment.

string path = Server.MapPath("~/uploads");
// Returns: C:\inetpub\wwwroot\uploads

// Same code works!
string path = Server.MapPath("~/uploads");
// Returns: /app/wwwroot/uploads

2. Server.HtmlEncode()

Encodes text for safe HTML display, preventing XSS. Same API as Web Forms.

string safe = Server.HtmlEncode(userInput);
lblOutput.Text = safe;

// Same code works!
string safe = Server.HtmlEncode(userInput);

3. Server.UrlEncode()

Encodes text for safe use in URLs. Same API as Web Forms.

string encoded = Server.UrlEncode(searchTerm);
Response.Redirect("search.aspx?q=" + encoded);

// Same code works!
string encoded = Server.UrlEncode(searchTerm);

4. ResolveUrl()

ResolveUrl("~/Products.aspx") strips the ~/ prefix and .aspx extension, producing a clean Blazor route.

string url = ResolveUrl("~/Products.aspx");
// Returns: /Products.aspx

// Same call, cleaner output
string url = ResolveUrl("~/Products.aspx");
// Returns: /Products