📄 Documentation: IrbyImaging/Views/Manufacturers/Edit.cshtml


📑 Table of Contents

  1. Overview & Purpose
  2. Key Functional Areas
  3. Dependencies & Technologies
  4. View Model & Data Model
  5. Form Structure & Fields
  6. Client‑side Validation
  7. Third‑party Integrations
  8. Sample Code Snippets
  9. Usage Examples
  10. UML Diagram
  11. 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"
  • 📝 Form Rendering

    • Uses ASP.NET Core Tag Helpers (asp-action, asp-for)
    • Displays validation summaries and field‑specific errors
  • 🔘 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)

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 Id property is passed back to the server (e.g., via a hidden field) so that the POST Edit action 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?&nbsp;&nbsp;
    </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>
    &nbsp;&nbsp;
    <input type="submit" value="Update" class="btn btn-success irby-green" />
  </div>
</form>
  • asp-action="Edit": Targets the POST Edit action.
  • 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>
  1. Bootstrap – Responsive layout & components
  2. MetisMenu – Toggleable side menus
  3. SimpleBar – Custom scrollbar styling
  4. 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?&nbsp;&nbsp;
        </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>
        &nbsp;&nbsp;
        <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

  1. Navigate to edit form
    GET /Manufacturers/Edit/5
    
  2. 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! 🚀