📄 Documentation: IrbyImaging/Views/Manufacturers/Edit.cshtml
📑 Table of Contents
- Overview & Purpose
- Key Functional Areas
- Dependencies & Technologies
- View Model & Data Model
- Form Structure & Fields
- Client‑side Validation
- Third‑party Integrations
- Sample Code Snippets
- Usage Examples
- UML Diagram
- Conclusion
1. Overview & Purpose
✨ Purpose
This Razor view renders an Edit form for updating an existing Manufacturer in the IrbyImaging application.
- File path:
Views/Manufacturers/Edit.cshtml - Controller action:
ManufacturersController.Edit (GET & POST) - Layout used:
_ATSLayout.cshtml - Model bound:
IrbyImaging.DomainClasses.Manufacturer
2. Key Functional Areas
-
📌 Page Setup
- Sets
ViewData["Title"] = "Edit" - Applies the shared layout via
Layout = "~/Views/Shared/_ATSLayout.cshtml"
- Sets
-
📝 Form Rendering
- Uses ASP.NET Core Tag Helpers (
asp-action,asp-for) - Displays validation summaries and field‑specific errors
- Uses ASP.NET Core Tag Helpers (
-
🔘 Fields
- Name (text input)
- IsAvailableOption (checkbox)
-
🚀 Actions
- Index List button (navigates back to list view)
- Update button (submits changes)
-
📑 Script Section
- Loads unobtrusive validation (
_ValidationScriptsPartial) - Includes UI/UX libraries (Bootstrap, MetisMenu, SimpleBar, Waves)
- Loads unobtrusive validation (
3. Dependencies & Technologies
| Technology | Usage |
|---|---|
| ASP.NET Core MVC / Razor | Tag Helpers, Layouts, Partial Rendering |
| C# (.NET 6.0+ assumed) | Server‑side model binding & validation |
| Bootstrap 5.x | Grid system, form styles, buttons |
| MetisMenu | Sidebar/menu toggling |
| SimpleBar | Custom scrollbars |
| Node‑Waves | Material‑style click ripple effects |
| jQuery Validation & Unobtrusive | _ValidationScriptsPartial for client validation |
4. View Model & Data Model
Model class:
namespace IrbyImaging.DomainClasses
{
public class Manufacturer
{
public int Id { get; set; }
public string Name { get; set; }
public bool IsAvailableOption { get; set; }
}
}
🔧 Tip: Ensure that the
Idproperty is passed back to the server (e.g., via a hidden field) so that the POSTEditaction can identify the correct record to update.
5. Form Structure & Fields
<form asp-action="Edit">
<!-- Validation Summary -->
<div asp-validation-summary="ModelOnly" class="text-danger"></div>
<!-- Name Field -->
<div class="form-group">
<label asp-for="Name" class="control-label"></label>
<input asp-for="Name" class="form-control" />
<span asp-validation-for="Name" class="text-danger"></span>
</div>
<!-- IsAvailableOption Checkbox -->
<div class="form-group">
<label asp-for="IsAvailableOption" class="control-label">
Make this option available?
</label>
<input asp-for="IsAvailableOption" class="checkbox-inline" />
<span asp-validation-for="IsAvailableOption" class="text-danger"></span>
</div>
<!-- Action Buttons -->
<div class="form-group">
<a asp-action="Index" class="btn btn-danger irby-red">Index List</a>
<input type="submit" value="Update" class="btn btn-success irby-green" />
</div>
</form>
asp-action="Edit": Targets the POSTEditaction.- Validation:
<div asp-validation-summary="ModelOnly">for model‑level messages<span asp-validation-for="…" />for field‑level errors
6. Client‑side Validation
- Unobtrusive Validation
@section Scripts { @{ await Html.RenderPartialAsync("_ValidationScriptsPartial"); } } - Ensures required fields are filled and correct formats before form submission.
7. Third‑party Integrations
<script src="~/libs/bootstrap/js/bootstrap.bundle.min.js"></script>
<script src="~/libs/metismenu/metisMenu.min.js"></script>
<script src="~/libs/simplebar/simplebar.min.js"></script>
<script src="~/libs/node-waves/waves.min.js"></script>
- Bootstrap – Responsive layout & components
- MetisMenu – Toggleable side menus
- SimpleBar – Custom scrollbar styling
- Node‑Waves – Click ripple effects for modern UI
8. Sample Code Snippets
Complete Edit.cshtml
@model IrbyImaging.DomainClasses.Manufacturer
@{
ViewData["Title"] = "Edit";
Layout = "~/Views/Shared/_ATSLayout.cshtml";
}
<h2>Update Manufacturer</h2>
<hr />
<div class="row">
<div class="col-md-4">
<form asp-action="Edit">
<div asp-validation-summary="ModelOnly" class="text-danger"></div>
<!-- Name -->
<div class="form-group">
<label asp-for="Name" class="control-label"></label>
<input asp-for="Name" class="form-control" />
<span asp-validation-for="Name" class="text-danger"></span>
</div>
<!-- Availability -->
<div class="form-group">
<label asp-for="IsAvailableOption" class="control-label">
Make this option available?
</label>
<input asp-for="IsAvailableOption" class="checkbox-inline" />
<span asp-validation-for="IsAvailableOption" class="text-danger"></span>
</div>
<!-- Buttons -->
<div class="form-group">
<a asp-action="Index" class="btn btn-danger irby-red">Index List</a>
<input type="submit" value="Update" class="btn btn-success irby-green" />
</div>
</form>
</div>
</div>
@section Scripts {
@{ await Html.RenderPartialAsync("_ValidationScriptsPartial"); }
}
<!-- UI Libraries -->
<script src="~/libs/bootstrap/js/bootstrap.bundle.min.js"></script>
<script src="~/libs/metismenu/metisMenu.min.js"></script>
<script src="~/libs/simplebar/simplebar.min.js"></script>
<script src="~/libs/node-waves/waves.min.js"></script>
9. Usage Examples
- Navigate to edit form
GET /Manufacturers/Edit/5 - Submit form
POST /Manufacturers/Edit Content-Type: application/x-www-form-urlencoded Id=5&Name=Contoso&IsAvailableOption=true
10. UML Diagram
classDiagram
class Manufacturer {
+int Id
+string Name
+bool IsAvailableOption
}
11. Conclusion
✅ The Edit.cshtml view provides a clean, semantic interface for updating Manufacturer records. It leverages ASP.NET Core Tag Helpers for rapid development, integrates popular front‑end libraries for a polished UI, and supports unobtrusive client‑side validation.
🔧 Next Steps:
- Ensure your controller’s POST action correctly binds
Id(add a hidden field if missing). - Extend with additional fields or custom validation as your domain requires.
Happy coding! 🚀