Add LinkGenerator extensions

README.md

@@ -61,6 +61,9 @@ Similarly, consider the following razor page model class:
 ```csharp
 public sealed class EditModel : PageModel
 {
+  [FromRoute]
+  public int Id { get; set; }
+
   public void OnGet()
   {
     // ...
@@ -76,7 +79,7 @@ public sealed class EditModel : PageModel
 The generated code enables you to access the URL for the `OnGet` handler with the following code:
 
 ```csharp
-string? editUrl = Routes.Pages.Edit.Get().Url(Url);
+string? editUrl = Routes.Pages.Edit.Get(123).Url(Url);
 ```
 
 ## Installation
@@ -98,7 +101,7 @@ This enables `for-route` attributes to be added to `<a>`, `<img>`, and `<form>`
 ```cshtml
 @{
   var controllerRoute = Routes.Controllers.Product.Search("chair", 10);
-  var pageRoute = Routes.Pages.Edit.Post();
+  var pageRoute = Routes.Pages.Edit.Post(Model.Id);
 }
 
 <!-- Adds the URL in the href attribute -->
@@ -149,6 +152,15 @@ route.Remove(route.Properties.Limit);
 // Value: "/Product/Search/book"
 string? routeUrl = route.Url(Url);
 
+// Get route information for the OnGet method on the /Edit page
+var pageRoute = Routes.Pages.Edit.Get(123);
+
+// "/Edit?Id=123"
+var path = pageRoute.Path(linkGenerator);
+
+// "https://example.org/Edit?Id=123"
+var uri = pageRoute.Url(linkGenerator, "https", new HostString("example.org"));
+
 // Redirect from within a controller action method or a page handler method
 return route.Redirect(this);
 ```

src/Demo/SafeRouting.Demo/Controllers/UsageExampleController.cs

@@ -21,12 +21,12 @@ public IActionResult SourceGeneratorRedirect()
   public string? PageUrl()
   {
     #region EditUrl
-    string? editUrl = Routes.Pages.Edit.Get().Url(Url);
+    string? editUrl = Routes.Pages.Edit.Get(123).Url(Url);
     #endregion
     return editUrl;
   }
 
-  public IActionResult GettingStarted()
+  public IActionResult GettingStarted([FromServices] LinkGenerator linkGenerator)
   {
 #pragma warning disable IDE0059 // Unnecessary assignment of a value
     #region GettingStarted
@@ -57,6 +57,15 @@ public IActionResult GettingStarted()
     // Value: "/Product/Search/book"
     string? routeUrl = route.Url(Url);
 
+    // Get route information for the OnGet method on the /Edit page
+    var pageRoute = Routes.Pages.Edit.Get(123);
+
+    // "/Edit?Id=123"
+    var path = pageRoute.Path(linkGenerator);
+
+    // "https://example.org/Edit?Id=123"
+    var uri = pageRoute.Url(linkGenerator, "https", new HostString("example.org"));
+
     // Redirect from within a controller action method or a page handler method
     return route.Redirect(this);
     #endregion

src/Demo/SafeRouting.Demo/Pages/Edit.cshtml

@@ -4,7 +4,7 @@
 
 @{
   var controllerRoute = Routes.Controllers.Product.Search("chair", 10);
-  var pageRoute = Routes.Pages.Edit.Post();
+  var pageRoute = Routes.Pages.Edit.Post(Model.Id);
 }
 
 <!-- Adds the URL in the href attribute -->

src/Demo/SafeRouting.Demo/Pages/Edit.cshtml.cs

@@ -1,3 +1,4 @@
+using Microsoft.AspNetCore.Mvc;
 using Microsoft.AspNetCore.Mvc.RazorPages;
 
 namespace SafeRouting.Demo.Pages;
@@ -6,6 +7,9 @@ namespace SafeRouting.Demo.Pages;
 
 public sealed class EditModel : PageModel
 {
+  [FromRoute]
+  public int Id { get; set; }
+
   public void OnGet()
   {
     // ...