TextBox.AutoCompleteMode Property

Gets or sets an option that controls how automatic completion works for the TextBox.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

public AutoCompleteMode AutoCompleteMode { get; set; }
/** @property */
public AutoCompleteMode get_AutoCompleteMode ()

/** @property */
public void set_AutoCompleteMode (AutoCompleteMode value)

public function get AutoCompleteMode () : AutoCompleteMode

public function set AutoCompleteMode (value : AutoCompleteMode)

Not applicable.

Property Value

One of the values of AutoCompleteMode. The values are Append, None, Suggest, and SuggestAppend. The default is None.

Exception typeCondition


The specified value is not one of the values of AutoCompleteMode.

Use the AutoCompleteCustomSource, AutoCompleteMode, and AutoCompleteSource properties to create a TextBox that automatically completes input strings by comparing the prefix being entered to the prefixes of all strings in a maintained source. This is useful for TextBox controls in which URLs, addresses, file names, or commands will be frequently entered.

The use of the AutoCompleteCustomSource property is optional, but you must set the AutoCompleteSource property to CustomSource in order to use AutoCompleteCustomSource.

You must use the AutoCompleteMode and AutoCompleteSource properties together.


The operating system might limit the number of custom strings that it can display at once.

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0