@Model.Title
@Model.Content
My Page
Content goes here
This is a templated Razor delegate. The following value was passed in: @item
;
}
@tmpl(DateTime.Now)
```
--------------------------------
### Return RazorSlices from Minimal APIs (Direct)
Source: https://github.com/damianedwards/razorslices/blob/main/_autodocs/quick-reference.md
Example of directly returning a RazorSlice instance from a Minimal API endpoint.
```csharp
app.MapGet("/", () => Slices.Home.Create());
```
--------------------------------
### Render RazorSlice to Stream
Source: https://github.com/damianedwards/razorslices/blob/main/_autodocs/quick-reference.md
Example of rendering a RazorSlice directly to a stream, such as a MemoryStream.
```csharp
var slice = MySlice.Create();
var stream = new MemoryStream();
var writer = new StreamWriter(stream);
await slice.RenderAsync(writer);
```
--------------------------------
### RenderBodyAsync Example
Source: https://github.com/damianedwards/razorslices/blob/main/_autodocs/layouts.md
Demonstrates how to use `RenderBodyAsync` within a layout's `.cshtml` file to inject the child slice's body content. This is typically placed in the main content area of the layout.
```cshtml
@inherits RazorLayoutSlice
Welcome
@Model.Title
Due: @Model.DueDate
Complete: @(Model.IsComplete ? "Yes" : "No")
@Title(Model)
@functions { private IHtmlContent Title(Todo todo) {Order #@Model.Id
@foreach (var item in Model.Items)
{
@(await RenderPartialAsync(item))
}
This page renders a custom IHtmlContent type that contains lorem ipsum content.
@Model.Name
Price: @WriteNumber(Model.Price, "C")
In Stock: @WriteBool(Model.InStock)
``` -------------------------------- ### Configure _ViewImports.cshtml for Razor Slices Source: https://github.com/damianedwards/razorslices/blob/main/_autodocs/INDEX.md Set up the _ViewImports.cshtml file to inherit from RazorSlice and import necessary namespaces. ```cshtml @inherits RazorSlice @using RazorSlices ``` -------------------------------- ### Handle Not Found Response Source: https://github.com/damianedwards/razorslices/blob/main/_autodocs/quick-reference.md Return a 404 Not Found result when a requested resource is not found. This snippet demonstrates how to check for a null user and return `Results.NotFound()`. ```csharp app.MapGet("/user/{id}", (int id) => { var user = GetUser(id); if (user == null) return Results.NotFound(); return Results.RazorSliceHello from Razor Slices! The time is @Model
``` -------------------------------- ### IUsesLayout
Click
Welcome
``` ```csharp app.MapGet("/", () => Slices.HomePage.Create()); ``` -------------------------------- ### Recommended _ViewImports.cshtml Content Source: https://github.com/damianedwards/razorslices/blob/main/_autodocs/configuration.md This Razor syntax provides recommended shared imports for all Razor Slices within a directory and its subdirectories. It includes base class inheritance, common namespaces, and disabling tag helpers that require MVC. ```cshtml @inherits RazorSlice @using System.Globalization @using Microsoft.AspNetCore.Razor @using Microsoft.AspNetCore.Http.HttpResults @using RazorSlices @using YourApp.Models @using YourApp.Services @* Disable tag helpers that require MVC *@ @tagHelperPrefix __disable_tagHelpers__: @removeTagHelper *, Microsoft.AspNetCore.Mvc.Razor ``` -------------------------------- ### RenderAsync (TextWriter Overload) Source: https://github.com/damianedwards/razorslices/blob/main/_autodocs/razor-slice-base.md Renders the template to a `TextWriter`. This method is suitable for scenarios where you are working with synchronous writers or need to integrate with existing text-based output mechanisms. ```APIDOC ## RenderAsync (TextWriter Overload) ### Description Renders the template to a `TextWriter`. ### Method `RenderAsync` ### Parameters #### Path Parameters None #### Query Parameters None #### Request Body None ### Parameters - **textWriter** (`TextWriter`) - Required - The text writer to render to. - **htmlEncoder** (`HtmlEncoder?`) - Optional - Custom HTML encoder; defaults to `HtmlEncoder.Default`. - **cancellationToken** (`CancellationToken`) - Optional - Cancellation token for the operation. ### Return Type `ValueTask` — completes when rendering finishes ### Throws `ArgumentNullException` if `textWriter` is `null` ### Example ```csharp var slice = MySlice.Create(); using var writer = new StreamWriter(outputStream); await slice.RenderAsync(writer); await writer.FlushAsync(); ``` ``` -------------------------------- ### Render Raw HTML Source: https://github.com/damianedwards/razorslices/blob/main/_autodocs/quick-reference.md Use `Html.Raw()` or `WriteHtml()` to render pre-encoded HTML content without further encoding. Use this cautiously when dealing with trusted HTML sources. ```cshtml@Html.Raw(Model.HtmlContent)
@WriteHtml(preEncodedContent)
```
--------------------------------
### Create Razor Slice with Model
Source: https://github.com/damianedwards/razorslices/blob/main/_autodocs/quick-reference.md
Create a Razor Slice that accepts a model for dynamic content rendering. Ensure the model type is correctly specified in the `@inherits` directive.
```cshtml
@inherits RazorSlice@Model.Name
@Model.Description
``` ```csharp app.MapGet("/products/{id}", (int id) => { var product = GetProduct(id); return Slices.ProductPage.Create(product); }); ``` -------------------------------- ### Add RazorSlices Package via CLI Source: https://github.com/damianedwards/razorslices/blob/main/_autodocs/configuration.md Use the .NET CLI to add the RazorSlices NuGet package to your project. ```bash dotnet add package RazorSlices ``` -------------------------------- ### Content Slice (Pages/Product.cshtml) Source: https://github.com/damianedwards/razorslices/blob/main/_autodocs/layouts.md Represents a specific content component for a product page. It implements the layout interface and defines how to render product details and inject content into layout sections. ```cshtml @inherits RazorSlice@Model.Name
@Model.Description
$@Model.Price:N2
Hello from Razor Slices
``` -------------------------------- ### HTML Attribute Methods Source: https://github.com/damianedwards/razorslices/blob/main/_autodocs/INDEX.md Methods for programmatically writing HTML attributes. ```APIDOC ## BeginWriteAttribute(...) ### Description Starts the process of writing an HTML attribute. ### Method `BeginWriteAttribute` ### Parameters - `...` - Arguments defining the attribute (e.g., name, type). ### Source `RazorSlice` ``` ```APIDOC ## WriteAttributeValue@Model.Title
@Model.Content
@Model.Title
@Model.Content