AutoFormsKit 8.6.4

AutoFormsKit

Автоматическая генерация WinForms-диалогов и CRUD-форм из любого C#-класса модели. Без ручного создания UI.

Установка

dotnet add package AutoFormsKit

Возможности

• Автоматическое создание диалоговых окон из свойств модели
• Поддержка валидации: [Required], [StringLength], [MaxLength], [DataType]
• Выпадающие списки для связанных сущностей (DropdownSource)
• Готовые CRUD-вкладки с DataGridView и кнопками Добавить/Редактировать/Удалить
• Автоматическое определение типа контрола по типу свойства (CheckBox для bool, DateTimePicker для DateTime, NumericUpDown для чисел, ComboBox для enum)
• Подсветка обязательных полей красным при ошибке валидации
• Свойство Id/ID автоматически скрывается из формы

API

Класс AutoDialog

Класс AutoCrudForm

Класс DropdownSource

Поддержка валидации

• [Required] -- обязательное поле, подсвечивается красным при пустом значении
• [Required(ErrorMessage = "...")] -- пользовательское сообщение об ошибке
• [StringLength(100)] -- ограничение максимальной длины ввода в TextBox
• [MaxLength(50)] -- ограничение максимальной длины ввода в TextBox
• [DataType(DataType.MultilineText)] -- многострочное текстовое поле (TextBox с прокруткой)
• [Display(Name = "...")] -- отображаемое имя поля в форме вместо имени свойства

Примеры

Пример 1: Кадровый учет

using AutoForms;
using System.ComponentModel.DataAnnotations;

public class Employee
{
    public int Id { get; set; }

    [Required(ErrorMessage = "Укажите ФИО")]
    [Display(Name = "ФИО сотрудника")]
    [StringLength(100)]
    public string FullName { get; set; } = "";

    [Display(Name = "Должность")]
    public string Position { get; set; } = "";

    [Display(Name = "Зарплата")]
    public decimal Salary { get; set; }

    [Display(Name = "Дата приема")]
    public DateTime HireDate { get; set; }
}

// Создание нового сотрудника
var employee = AutoDialog.CreateNew<Employee>("Новый сотрудник");
if (employee != null)
{
    db.Employees.Add(employee);
    db.SaveChanges();
}

// Редактирование
AutoDialog.Edit(employee, "Редактировать сотрудника");

// Удаление с подтверждением
if (AutoDialog.ConfirmDelete("Удалить сотрудника?"))
{
    db.Employees.Remove(employee);
    db.SaveChanges();
}

Пример 2: Связанные сущности с выпадающими списками

public class Order
{
    public int Id { get; set; }

    [Required]
    [Display(Name = "Номер заказа")]
    public string OrderNumber { get; set; } = "";

    [Display(Name = "Клиент")]
    public int ClientId { get; set; }

    [Display(Name = "Сумма")]
    public decimal Total { get; set; }
}

var clients = db.Clients.ToList();
var order = AutoDialog.CreateNew<Order>("Новый заказ",
    new DropdownSource("ClientId", clients, "FullName", "Id"));

Пример 3: Полноценная CRUD-форма с вкладками

using AutoForms;

var tabControl = new TabControl { Dock = DockStyle.Fill };

var departments = db.Departments.ToList();

tabControl.TabPages.Add(AutoCrudForm.CreateTab<Department>(db, "Отделы"));
tabControl.TabPages.Add(AutoCrudForm.CreateTab<Employee>(db, "Сотрудники",
    new DropdownSource("DepartmentId", departments, "Name", "Id")));

this.Controls.Add(tabControl);