用途:面向 Windows Forms 应用,为文本输入框添加自动建议和自动补全,适合地址、URL、邮箱、姓名等重复性输入场景,也支持大数据集过滤建议。
主要能力:通过 SetAutoComplete 将控件绑定到 TextBox;支持多种数据源(字符串数组、List/ArrayList、DataTable/DataSet、实现 IList 的自定义对象);提供 Suggest、Append、SuggestAppend(代码中为 AutoCompleteModes.AutoSuggest、Both)等模式;支持多列下拉展示(AutoCompleteDataColumnInfo);可设置 DisplayMember、ValueMember、CharacterCasing、LoadOnDemand;支持下拉项自定义绘制;提供 AutoCompleteValueChanged、AutoCompleteCustomize、BeforeCustomization 等事件;内置多种视觉样式(如 Office2016Colorful、Metro 等)。
使用方式:通过 NuGet 安装 Install-Package Syncfusion.Tools.Windows,引用 Syncfusion.Tools.Windows.dll 与 Syncfusion.Shared.Base.dll;创建 AutoComplete 实例后必须设置 ParentForm,再设置 DataSource 并调用 SetAutoComplete(textBox1, AutoCompleteModes.AutoSuggest),最后把 TextBox 加入窗体控件集合。
适用场景:需要 type-ahead 搜索、带建议的搜索框、表单常用值补全、多列信息下拉选择、大数据集按需加载等。
限制与注意事项:资料未提供价格、授权和效果数据;ParentForm 为必填项,否则下拉不显示;多列显示需设置合适的 Style 并确保 DataSource 列名与列配置匹配;大数据集建议启用 LoadOnDemand;重置建议可调用 ResetItems() 或设 DataSource = null。支持 .NET Framework 4.5+ 及 .NET 6/7/8、.NET Core 3.1(Windows)。