如何为Radzen组件正确使用RadzenRequiredValidator

基础用法（直接绑定组件） #

如果不需要结合模型验证，可直接将验证器与Radzen输入组件的引用绑定：

<!-- 输入组件，通过@ref获取引用 -->
<RadzenTextBox @bind-Value="@UserName" @ref="userNameInput" Placeholder="请输入用户名" />
<!-- 必填验证器，Component属性绑定输入组件引用 -->
<RadzenRequiredValidator Component="@userNameInput" Text="用户名不能为空" Style="color:red;" />

@code {
    private string UserName { get; set; }
    private RadzenTextBox userNameInput;
}

结合DataAnnotations模型验证（推荐） #

这是Blazor开发中更规范的方式，通过模型的[Required]特性配合验证器：

1. 定义带验证特性的模型

public class UserForm
{
    [Required(ErrorMessage = "请输入用户名")]
    public string UserName { get; set; }

    [Required(ErrorMessage = "请选择角色")]
    public string Role { get; set; }
}

2. 在组件中使用EditForm和验证器

<EditForm Model="@UserModel" OnValidSubmit="@HandleValidSubmit">
    <!-- 启用DataAnnotations验证 -->
    <DataAnnotationsValidator />
    
    <!-- 用户名输入 + 必填验证 -->
    <RadzenTextBox @bind-Value="@UserModel.UserName" Placeholder="用户名" />
    <RadzenRequiredValidator For="@(() => UserModel.UserName)" />

    <!-- 下拉框输入 + 必填验证 -->
    <RadzenDropDown @bind-Value="@UserModel.Role" Data="@Roles" TextProperty="Value" ValueProperty="Key" Placeholder="选择角色" />
    <RadzenRequiredValidator For="@(() => UserModel.Role)" />

    <!-- 提交按钮，仅当验证通过时触发OnValidSubmit -->
    <RadzenButton ButtonType="ButtonType.Submit" Text="提交" />
</EditForm>

@code {
    private UserForm UserModel { get; set; } = new UserForm();
    private Dictionary<string, string> Roles = new()
    {
        { "admin", "管理员" },
        { "user", "普通用户" }
    };

    private void HandleValidSubmit()
    {
        // 验证通过，处理提交逻辑
    }
}

手动触发验证 #

如果需要在特定时机（比如按钮点击）手动触发验证，可通过EditContext实现：

<EditForm @ref="editFormRef" Model="@UserModel">
    <DataAnnotationsValidator />
    
    <RadzenTextBox @bind-Value="@UserModel.UserName" />
    <RadzenRequiredValidator For="@(() => UserModel.UserName)" Text="用户名不能为空" />

    <RadzenButton Text="检查输入" Click="@TriggerValidation" />
</EditForm>

@code {
    private EditForm editFormRef;
    private UserForm UserModel { get; set; } = new UserForm();

    private void TriggerValidation()
    {
        // 手动触发整个表单的验证
        var isValid = editFormRef.EditContext.Validate();
        if (isValid)
        {
            // 验证通过逻辑
        }
    }
}

关键注意事项 #

• RadzenRequiredValidator需绑定Component（组件引用）或For（模型属性）二者之一，不能同时省略
• 若使用For属性，必须确保组件包裹在EditForm内，且添加了DataAnnotationsValidator
• 验证默认在输入组件失去焦点、表单提交时自动触发
• 支持所有Radzen输入组件（如RadzenDatePicker、RadzenCheckBoxList等），用法一致

内容的提问来源于stack exchange，提问作者senpai.maku