MaskedTextBox.ResetOnSpace Property

Note: This property is new in the .NET Framework version 2.0.

Gets or sets a value that determines how a space input character should be handled.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in

public bool ResetOnSpace { get; set; }
/** @property */
public boolean get_ResetOnSpace ()

/** @property */
public void set_ResetOnSpace (boolean value)

public function get ResetOnSpace () : boolean

public function set ResetOnSpace (value : boolean)

Property Value

true if the space input character causes the current editable position in the mask to be reset; otherwise, false to indicate that it is to be processed as a normal input character. The default is true.

The MaskedTextBox can treat two categories of characters—spaces and prompt characters—specially. Typically, each input character will be tested against the mask and either accepted or rejected. Setting the ResetOnSpace property to true will result in the current mask character position to be cleared and the current position to be advanced to the next editable character.

The type of character input will determine whether the masking engine moves forward to the next character in the mask, or stays at the current position and waits for a matching character. If the input character is a space, and does not match the current non-editable character in the mask, the masking engine will skip ahead to the next character in the mask. If the input character is not a space, and does not match the current non-editable character in the mask, the masking engine will remain at the current mask position, and attempt to match the next input character against it.

Windows 98, Windows 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 .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0