TexBox.AutoCompleteSource

属性值

类型：System.Windows.Forms.AutoCompleteSource
AutoCompleteSource 值之一。这些选项为 AllSystemSources、AllUrl、FileSystem、HistoryList、RecentlyUsedList、CustomSource 和 None。默认值为 None。

备注

使用 AutoCompleteCustomSource、AutoCompleteMode 和 AutoCompleteSource 属性可以创建一个 TextBox，它通过将所输入的前缀与所维护的源中的所有字符串的前缀进行比较来自动完成输入字符串。这对于频繁地有 URL、地址、文件名或命令输入其中的 TextBox 控件来说很有用。

AutoCompleteCustomSource 属性的使用是可选的，但必须将 AutoCompleteSource 属性设置为 CustomSource 后才能使用 AutoCompleteCustomSource。

AutoCompleteMode 和 AutoCompleteSource 属性必须一起使用。

说明
AutoCompleteSource 不适用于多行 TextBox 控件。

说明
操作系统可能会限制可以同时显示的自定义字符串的数目。

示例

下面的代码示例演示如何使用作为 TextBox 控件的自动完成自定义源的集合。此示例将执行下列操作：

使用 AutoCompleteSource 属性使 TextBox 控件能够接受其自动完成行为的自定义源。
使用 AutoCompleteCustomSource 属性设置值的自定义列表。
使用 AutoCompleteMode 属性设置自动完成候选人的显示方式。

private void Form1_Load(object sender, EventArgs e)
{
    // Create the list to use as the custom source. 
    var source = new AutoCompleteStringCollection();
    source.AddRange(new string[]
                    {
                        "January",
                        "February",
                        "March",
                        "April",
                        "May",
                        "June",
                        "July",
                        "August",
                        "September",
                        "October",
                        "November",
                        "December"
                    });

    // Create and initialize the text box.
    var textBox = new TextBox
                  {
                      AutoCompleteCustomSource = source,
                      AutoCompleteMode = 
                          AutoCompleteMode.SuggestAppend,
                      AutoCompleteSource =
                          AutoCompleteSource.CustomSource,
                      Location = new Point(20, 20),
                      Width = ClientRectangle.Width - 40,
                      Visible = true
                  };

    // Add the text box to the form.
    Controls.Add(textBox);
}