Syncfusion .NET MAUI NumericUpDown
SfNumericUpDown 控件提供友好的数值输入体验，内置验证、格式化选项以及便捷的增减按钮，适合构建需要经过验证的数值输入的专业表单。
何时使用此技能
当你需要以下场景时，可使用此技能：
- 在 .NET MAUI 应用中构建数值输入字段
- 将数字格式化为货币（C2）、百分比（P2）或小数（N2）
- 将输入限制在有效范围内（Minimum/Maximum 值）
- 通过上下箭头按钮或键盘控件快速调整数值
- 为空数值字段显示占位符
- 使用 OnKeyFocus 或 OnLostFocus 模式自动处理验证
- 自定义按钮、颜色、边框和字体的外观
- 支持区域性格式，实现区域感知的数字显示
组件概述
SfNumericUpDown（或 NumericUpDown）控件是专为在 .NET MAUI 应用中输入和编辑数值而设计的专用输入字段。它结合了三种交互模式：
功能说明：
- 接受数值输入，可选文本字段用于直接输入
- 提供增减按钮（上下箭头）用于快速调整数值
- 支持键盘导航（方向键、Page Up/Down、Tab、Return）
- 通过可配置范围（Minimum/Maximum）强制执行验证
- 根据区域性、货币或自定义规范格式化数字
- 未设置值时显示占位符文本
关键特性：
- 智能验证：OnKeyFocus（实时）或 OnLostFocus（延迟）验证模式
- 灵活格式化：货币（C2）、百分比（P2）、小数（N2）或自定义格式
- 可自定义按钮：放置模式（Inline、InlineVertical）、对齐方式（Left、Right、Both）、颜色和自定义模板
- 约束支持：最小/最大范围、空值处理（AllowNull）、纯文本模式（IsEditable=false）
- 事件驱动：ValueChanged、Completed、Focused/Unfocused 事件，便于表单集成
- 可访问性：支持 WCAG 合规、屏幕阅读器和纯键盘导航
何时选择 NumericUpDown：
- 需要带内置增减按钮的专业数值输入
- 希望无需自定义代码即可自动验证和格式化
- 构建财务表单（价格、折扣、百分比）
- 创建库存系统（数量、库存水平）
- 实现设置或偏好屏幕
- 需要区域感知的数字格式化
文档与导航指南
入门
📄 阅读：references/getting-started.md
- 安装和 NuGet 包设置
- 在 MauiProgram.cs 中注册处理程序
- 添加基本的 NumericUpDown 控件
- XAML 和 C# 初始化模式
- 首次渲染和验证模式
值管理与约束
📄 阅读：references/value-management.md
- 设置和绑定数值
- Minimum 和 Maximum 值限制
- 使用 AllowNull 属性处理空值
- 默认值和初始设置
- 使用 IsEditable 防止手动文本编辑
格式化与显示选项
📄 阅读：references/formatting-display.md
- 自定义数字格式（货币、百分比、小数）
- 占位符文本和占位符颜色自定义
- 区域感知的数字显示
- 最大小数位数管理
- 百分比显示模式（Value 与 Compute）
- 自定义格式说明符（0、#、C、P、N）
验证与事件
📄 阅读：references/validation-events.md
- 带 OldValue 和 NewValue 的 ValueChanged 事件
- 编辑完成时的 Completed 事件
- Focused 和 Unfocused 事件
- ValueChangeMode（OnKeyFocus 与 OnLostFocus）
- 编程式焦点管理
- Return 键命令
上下按钮控制
📄 阅读：references/buttons-updown.md
- SmallChange 和 LargeChange 增量
- 键盘快捷键（方向键、Page Up/Down）
- 鼠标滚轮支持
- 上下按钮放置模式（Inline、InlineVertical）
- 按钮对齐（Left、Right、Both）
- 按钮颜色自定义
- 自定义按钮模板
- 自动反转行为
自定义与 UI 功能
📄 阅读：references/customization.md
- 边框可见性和描边颜色
- 文本颜色和对齐方式自定义
- 字体系列、大小和属性
- 清除按钮可见性和自定义
- 光标位置和文本选择
- Return 键类型和键盘行为
- 高级样式模式
- 常见陷阱和故障排除