RadMaskedTextBox

Gets or sets a value which determines if empty mask parts are allowed.

[ClientControlProperty]
public bool AllowEmptyEnumerations { get; set; }

Property Value:

A value which determines if empty mask parts are allowed.

Columns

int

Gets or sets the number columns.

public virtual int Columns { get; set; }

Property Value:

The number columns.

DisplayFormatPosition

Gets or sets the format position when the RadMaskedTextBox is in display mode.

[ClientControlProperty]
public DisplayFormatPosition DisplayFormatPosition { get; set; }

Property Value:

The format position when the RadMaskedTextBox is in display mode.

DisplayMask

Gets or sets the display mask which is shown when the RadMaskedTextBox is not focused.

public string DisplayMask { get; set; }

Property Value:

The display mask which is shown when the RadMaskedTextBox is not focused.

DisplayMaskParts

Gets the MaskPartCollection which determines which mask parts will be used when the RadMaskedTextBox is not focused.

public MaskPartCollection DisplayMaskParts { get; }

Property Value:

The display mask parts.

DisplayPromptChar

Gets or sets the prompt character used in the display mask.

[ClientControlProperty]
public virtual string DisplayPromptChar { get; set; }

Property Value:

The prompt character used in the display mask.

HideOnBlur

Gets or sets if the prompt will be hidden when RadMaskedTextBox is blurred.

[ClientControlProperty]
public bool HideOnBlur { get; set; }

Property Value:

The hide on blur.

InitialDisplayMasks

protected virtual MaskPartCollection InitialDisplayMasks { get; }

InitialHiddenFieldValue

protected virtual string InitialHiddenFieldValue { get; }

InitialMasks

protected virtual MaskPartCollection InitialMasks { get; }

Mask

Gets or sets the RadMaskedTextBox mask.

public string Mask { get; set; }

Property Value:

The RadMaskedTextBox mask.

MaskParts

Gets the mask parts of a RadMaskedTextBox which determine which masks will be used for the control.

public MaskPartCollection MaskParts { get; }

Property Value:

The mask parts of a RadMaskedTextBox which determine which masks will be used for the control.

MaxLength

int

Gets or sets the maximum number of characters allowed in the text box.

[Browsable(false)]
public override int MaxLength { get; set; }

Property Value:

The maximum number of characters allowed in the text box. The default is 0, which indicates that the property is not set.

Overrides: RadInputControl.MaxLength

Use the MaxLength property to limit the number of characters that can be entered in the RadInput control. This property cannot be set by themes or style sheet themes. For more information, see ThemeableAttribute and Introduction to ASP.NET Themes.

Example:

cs-api-definition
&lt;/%@ Page Language="C#" AutoEventWireup="True" /%&gt;

&lt;/%@ Register Assembly="RadInput.Net2" Namespace="Telerik.WebControls" TagPrefix="radI" /%&gt;

&lt;!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"

"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"&gt;
&lt;html&gt;
&lt;head&gt;

&lt;title&gt;RadTextBox Example &lt;/title&gt;


&lt;script runat="server"&gt;


protected void AddButton_Click(Object sender, EventArgs e)
{

int Answer;


Answer = Convert.ToInt32(Value1.Text) + Convert.ToInt32(Value2.Text);


AnswerMessage.Text = Answer.ToString();


}


&lt;/script&gt;


&lt;/head&gt;
&lt;body&gt;
&lt;form id="form1" runat="server"&gt;

&lt;h3&gt;
RadTextBox Example
&lt;/h3&gt;
&lt;table&gt;

&lt;tr&gt;
&lt;td colspan="5"&gt;
Enter integer values into the text boxes.

&lt;br /&gt;
Click the Add button to add the two values.

&lt;br /&gt;
Click the Reset button to reset the text boxes.

&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td colspan="5"&gt;


&lt;/td&gt;
&lt;/tr&gt;
&lt;tr align="center"&gt;

&lt;td&gt;

&lt;radI:RadTextBox ID="Value1" Columns="2" MaxLength="3" Text="1" runat="server" /&gt;

&lt;/td&gt;
&lt;td&gt;
+
&lt;/td&gt;

&lt;td&gt;
&lt;radI:RadTextBox ID="Value2" Columns="2" MaxLength="3" Text="1" runat="server" /&gt;

&lt;/td&gt;
&lt;td&gt;
=
&lt;/td&gt;

&lt;td&gt;
&lt;asp:Label ID="AnswerMessage" runat="server" /&gt;
&lt;/td&gt;

&lt;/tr&gt;
&lt;tr&gt;
&lt;td colspan="2"&gt;

&lt;asp:RequiredFieldValidator ID="Value1RequiredValidator" ControlToValidate="Value1"

ErrorMessage="Please enter a value.&lt;br /&gt;" Display="Dynamic" runat="server" /&gt;

&lt;asp:RangeValidator ID="Value1RangeValidator" ControlToValidate="Value1" Type="Integer"

MinimumValue="1" MaximumValue="100" ErrorMessage="Please enter an integer &lt;br /&gt; between than 1 and 100.&lt;br /&gt;"

Display="Dynamic" runat="server" /&gt;
&lt;/td&gt;
&lt;td colspan="2"&gt;

&lt;asp:RequiredFieldValidator ID="Value2RequiredValidator" ControlToValidate="Value2"

ErrorMessage="Please enter a value.&lt;br /&gt;" Display="Dynamic" runat="server" /&gt;

&lt;asp:RangeValidator ID="Value2RangeValidator" ControlToValidate="Value2" Type="Integer"

MinimumValue="1" MaximumValue="100" ErrorMessage="Please enter an integer &lt;br /&gt; between than 1 and 100.&lt;br /&gt;"

Display="Dynamic" runat="server" /&gt;
&lt;/td&gt;
&lt;td&gt;

&amp;nbsp
&lt;/td&gt;
&lt;/tr&gt;
&lt;tr align="center"&gt;

&lt;td colspan="4"&gt;
&lt;asp:Button ID="AddButton" Text="Add" OnClick="AddButton_Click" runat="server" /&gt;

&lt;/td&gt;
&lt;td&gt;


&lt;/td&gt;
&lt;/tr&gt;
&lt;/table&gt;
&lt;/form&gt;
&lt;/body&gt;
&lt;/html&gt;
cs-api-definition.skip-repl
&lt;/%@ Page Language="VB" AutoEventWireup="True" /%&gt;


&lt;/%@ Register Assembly="RadInput.Net2" Namespace="Telerik.WebControls" TagPrefix="radI" /%&gt;

&lt;!DOCTYPE html Public "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"&gt;

&lt;html&gt;
&lt;head&gt;
&lt;title&gt;RadTextBox Example &lt;/title&gt;

&lt;script runat="server"&gt;


Protected Sub AddButton_Click(sender As Object, e As EventArgs)

Dim Answer As Integer


Answer = Convert.ToInt32(Value1.Text) + Convert.ToInt32(Value2.Text)

AnswerMessage.Text = Answer.ToString()


End Sub

&lt;/script&gt;

&lt;/head&gt;
&lt;body&gt;
&lt;form id="form1" runat="server"&gt;

&lt;h3&gt;
RadTextBox Example
&lt;/h3&gt;
&lt;table&gt;
&lt;tr&gt;

&lt;td colspan="5"&gt;
Enter Integer values into the text boxes.

&lt;br /&gt;
Click the Add button To add the two values.

&lt;br /&gt;
Click the Reset button To reset the text boxes.

&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td colspan="5"&gt;


&lt;/td&gt;
&lt;/tr&gt;
&lt;tr align="center"&gt;
&lt;td&gt;

&lt;radI:RadTextBox ID="Value1" Columns="2" MaxLength="3" Text="1" runat="server" /&gt;

&lt;/td&gt;
&lt;td&gt;
+
&lt;/td&gt;

&lt;td&gt;
&lt;radI:RadTextBox ID="Value2" Columns="2" MaxLength="3" Text="1" runat="server" /&gt;

&lt;/td&gt;
&lt;td&gt;
=
&lt;/td&gt;

&lt;td&gt;
&lt;asp:Label ID="AnswerMessage" runat="server" /&gt;

&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td colspan="2"&gt;

&lt;asp:RequiredFieldValidator ID="Value1RequiredValidator" ControlToValidate="Value1"

ErrorMessage="Please enter a value.&lt;br /&gt;" Display="Dynamic" runat="server" /&gt;

&lt;asp:RangeValidator ID="Value1RangeValidator" ControlToValidate="Value1" Type="Integer"

MinimumValue="1" MaximumValue="100" ErrorMessage="Please enter an integer &lt;br /&gt; between than 1 and 100.&lt;br /&gt;"

Display="Dynamic" runat="server" /&gt;
&lt;/td&gt;

&lt;td colspan="2"&gt;

&lt;asp:RequiredFieldValidator ID="Value2RequiredValidator" ControlToValidate="Value2"

ErrorMessage="Please enter a value.&lt;br /&gt;" Display="Dynamic" runat="server" /&gt;

&lt;asp:RangeValidator ID="Value2RangeValidator" ControlToValidate="Value2" Type="Integer"

MinimumValue="1" MaximumValue="100" ErrorMessage="Please enter an integer &lt;br /&gt; between than 1 and 100.&lt;br /&gt;"

Display="Dynamic" runat="server" /&gt;
&lt;/td&gt;

&lt;td&gt;
&amp;nbsp
&lt;/td&gt;
&lt;/tr&gt;

&lt;tr align="center"&gt;
&lt;td colspan="4"&gt;

&lt;asp:Button ID="AddButton" Text="Add" OnClick="AddButton_Click" runat="server" /&gt;

&lt;/td&gt;
&lt;td&gt;

&lt;/td&gt;

&lt;/tr&gt;
&lt;/table&gt;
&lt;/form&gt;
&lt;/body&gt;
&lt;/html&gt;

NumericRangeAlign

Gets or sets alignment of numeric ranges.

public NumericRangeAlign NumericRangeAlign { get; set; }

Property Value:

The alignment of numeric ranges.

PromptChar

Gets or sets the prompt char.

[ClientControlProperty]
public virtual string PromptChar { get; set; }

Property Value:

The prompt char.

ReadOnly

Gets or sets a value indicating whether the contents of the RadInput control can be changed.

[ClientControlProperty]
public override bool ReadOnly { get; set; }

Property Value:

true if the contents of the RadInput control cannot be changed; otherwise, false. The default value is false.

Overrides: RadInputControl.ReadOnly

Use the ReadOnly property to specify whether the contents of the RadInput control can be changed. Setting this property to true will prevent users from entering a value or changing the existing value. Note that the user of the RadInput control cannot change this property; only the developer can. The Text value of a RadInput control with the ReadOnly property set to true is sent to the server when a postback occurs, but the server does no processing for a read-only RadInput. This prevents a malicious user from changing a Text value that is read-only. The value of the Text property is preserved in the view state between postbacks unless modified by server-side code. This property cannot be set by themes or style sheet themes.

Example:

cs-api-definition
&lt;/%@ Page Language="C#" AutoEventWireup="True" /%&gt;

&lt;/%@ Register Assembly="RadInput.Net2" Namespace="Telerik.WebControls" TagPrefix="radI" /%&gt;

&lt;!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"

"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"&gt;
&lt;html&gt;
&lt;head&gt;

&lt;title&gt;MultiLine TextBox Example &lt;/title&gt;

&lt;script runat="server"&gt;
protected void SubmitButton_Click(Object sender, EventArgs e)

{

Message.Text = "Thank you for your comment: &lt;br /&gt;" + Comment.Text;

}

protected void Check_Change(Object sender, EventArgs e)
{

Comment.Wrap = WrapCheckBox.Checked;
Comment.ReadOnly = ReadOnlyCheckBox.Checked;

}

&lt;/script&gt;

&lt;/head&gt;
&lt;body&gt;
&lt;form id="form1" runat="server"&gt;
&lt;h3&gt;

MultiLine TextBox Example
&lt;/h3&gt;
Please enter a comment and click the submit button.

&lt;br /&gt;
&lt;br /&gt;

&lt;radI:RadTextBox ID="Comment" TextMode="MultiLine" Columns="50" Rows="5" runat="server" /&gt;

&lt;br /&gt;
&lt;asp:RequiredFieldValidator ID="Value1RequiredValidator" ControlToValidate="Comment"

ErrorMessage="Please enter a comment.&lt;br /&gt;" Display="Dynamic" runat="server" /&gt;

&lt;asp:CheckBox ID="WrapCheckBox" Text="Wrap Text" Checked="True" AutoPostBack="True"

OnCheckedChanged="Check_Change" runat="server" /&gt;

&lt;asp:CheckBox ID="ReadOnlyCheckBox" Text="ReadOnly" Checked="False" AutoPostBack="True"

OnCheckedChanged="Check_Change" runat="server" /&gt;

&lt;asp:Button ID="SubmitButton" Text="Submit" OnClick="SubmitButton_Click" runat="server" /&gt;

&lt;hr /&gt;
&lt;asp:Label ID="Message" runat="server" /&gt;
&lt;/form&gt;
&lt;/body&gt;

&lt;/html&gt;
cs-api-definition.skip-repl
&lt;/%@ Page Language="VB" AutoEventWireup="True" /%&gt;

&lt;/%@ Register Assembly="RadInput.Net2" Namespace="Telerik.WebControls" TagPrefix="radI" /%&gt;

&lt;!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"

"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"&gt;
&lt;html&gt;
&lt;head&gt;

&lt;title&gt;MultiLine RadTextBox Example &lt;/title&gt;

&lt;script runat="server"&gt;

Protected Sub SubmitButton_Click(sender As Object, e As EventArgs )

Message.Text = "Thank you for your comment: &lt;br /&gt;" + Comment.Text

End Sub

Protected Sub Check_Change(sender As Object, e As EventArgs )

Comment.Wrap = WrapCheckBox.Checked
Comment.ReadOnly = ReadOnlyCheckBox.Checked

End Sub

&lt;/script&gt;

&lt;/head&gt;
&lt;body&gt;
&lt;form id="form1" runat="server"&gt;
&lt;h3&gt;

MultiLine RadTextBox Example
&lt;/h3&gt;
Please enter a comment and click the submit button.

&lt;br /&gt;
&lt;br /&gt;

&lt;radI:RadTextBox ID="Comment" TextMode="MultiLine" Columns="50" Rows="5" runat="server" /&gt;

&lt;br /&gt;
&lt;asp:RequiredFieldValidator ID="Value1RequiredValidator" ControlToValidate="Comment"

ErrorMessage="Please enter a comment.&lt;br /&gt;" Display="Dynamic" runat="server" /&gt;

&lt;asp:CheckBox ID="WrapCheckBox" Text="Wrap Text" Checked="True" AutoPostBack="True"

OnCheckedChanged="Check_Change" runat="server" /&gt;

&lt;asp:CheckBox ID="ReadOnlyCheckBox" Text="ReadOnly" Checked="False" AutoPostBack="True"

OnCheckedChanged="Check_Change" runat="server" /&gt;

&lt;asp:Button ID="SubmitButton" Text="Submit" OnClick="SubmitButton_Click" runat="server" /&gt;

&lt;hr /&gt;
&lt;asp:Label ID="Message" runat="server" /&gt;
&lt;/form&gt;
&lt;/body&gt;

&lt;/html&gt;

RequireCompleteText

Gets or sets if it is required to complete entered text in the RadMaskedTextBox. By default is 'false'. Set to 'true' if you want full text to be required.

public bool RequireCompleteText { get; set; }

Property Value:

Determines if it is required to complete entered text in the RadMaskedTextBox. By default is 'false'. Set to 'true' if you want full text to be required.

ResetCaretOnFocus

Gets or sets if the caret will be moved to the begging when the RadMaskedTextBox is focused.

[ClientControlProperty]
public bool ResetCaretOnFocus { get; set; }

Property Value:

Determines if the caret will be moved to the begging when the RadMaskedTextBox is focused.

RoundNumericRanges

Gets or sets if the numberic ranges will be rounded.

[ClientControlProperty]
public bool RoundNumericRanges { get; set; }

Property Value:

Determines if the numberic ranges will be rounded.

Rows

int

Gets or sets the number of rows.

public virtual int Rows { get; set; }

Property Value:

The number of rows.

SelectionOnFocus

Gets or sets the selection on focus options for the RadInput control

[ClientControlProperty]
[Themeable(true)]
public override SelectionOnFocus SelectionOnFocus { get; set; }

Property Value:

A Telerik.WebControls.SelectionOnFocus object that represents the selection on focus in RadInput control. The default value is "None".

None
CaretToBeginning
CaretToEnd
SelectAll

Overrides: RadInputControl.SelectionOnFocus

Use this property to provide selection on focus of RadInput control. You can set one of the following values:

Example:

&lt;/%@ Page Language="C#" /%&gt;

&lt;/%@ Register Assembly="RadInput.Net2" Namespace="Telerik.WebControls" TagPrefix="radI" /%&gt;

&lt;!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"&gt;


&lt;html xmlns="http://www.w3.org/1999/xhtml" &gt;
&lt;head id="Head1" runat="server"&gt;

&lt;title&gt;RadTextBox selection&lt;/title&gt;
&lt;script runat="server"&gt;

protected void DropDownList1_SelectedIndexChanged(object sender, EventArgs e)
{

if (DropDownList1.SelectedValue == "CaretToBeginning")
{

this.RadTextBox1.SelectionOnFocus = Telerik.WebControls.SelectionOnFocus.CaretToBeginning;

}
else if (DropDownList1.SelectedValue == "CaretToEnd")
{

this.RadTextBox1.SelectionOnFocus = Telerik.WebControls.SelectionOnFocus.CaretToEnd;

}
else if (DropDownList1.SelectedValue == "SelectAll")
{

this.RadTextBox1.SelectionOnFocus = Telerik.WebControls.SelectionOnFocus.SelectAll;

}
}
&lt;/script&gt;
&lt;/head&gt;
&lt;body&gt;

&lt;form id="form1" runat="server"&gt;
&lt;div&gt;

&lt;radI:RadTextBox SelectionOnFocus="CaretToBeginning" ID="RadTextBox1" runat="server"&gt;&lt;/radI:RadTextBox&gt;

&lt;br /&gt;

&lt;asp:DropDownList AutoPostBack="true" ID="DropDownList1" runat="server" OnSelectedIndexChanged="DropDownList1_SelectedIndexChanged"&gt;

&lt;asp:ListItem Text="CaretToBeginning"&gt;CaretToBeginning&lt;/asp:ListItem&gt;

&lt;asp:ListItem Text="CaretToEnd"&gt;CaretToEnd&lt;/asp:ListItem&gt;

&lt;asp:ListItem Text="SelectAll"&gt;SelectAll&lt;/asp:ListItem&gt;

&lt;/asp:DropDownList&gt;&lt;/div&gt;
&lt;/form&gt;
&lt;/body&gt;
&lt;/html&gt;

Skin

Gets or sets the skin name for the control user interface.

public override string Skin { get; set; }

Property Value:

A string containing the skin name for the control user interface. The default is string.Empty.

Overrides: RadInputControl.Skin

If this property is not set, the control will render using the skin named "Default". If EnableEmbeddedSkins is set to false, the control will not render skin.

SmartPasteDescription

public virtual string SmartPasteDescription { get; set; }

TagKey

HtmlTextWriterTag

protected override HtmlTextWriterTag TagKey { get; }

Overrides: RadInputControl.TagKey

Text

Gets or sets the text content of a control.

public override string Text { get; set; }

Property Value:

The text content of a control.

Overrides: RadInputControl.Text

TextMode

InputMode

Gets or sets the text mode which could determine if the input will be multiline, password or normal single line input.

public InputMode TextMode { get; set; }

Property Value:

The text mode which could determine if the input will be multiline, password or normal single line input.

TextWithLiterals

Gets or sets the text including literals.

[Browsable(true)]
public string TextWithLiterals { get; set; }

Property Value:

The text including literals.

TextWithPrompt

Gets the text including the prompt.

[Browsable(true)]
public string TextWithPrompt { get; }

Property Value:

The text including the prompt.

TextWithPromptAndLiterals

Gets the text with prompt and literals.

[Browsable(true)]
public string TextWithPromptAndLiterals { get; }

Property Value:

The text with prompt and literals.

Wrap

If the Wrap property is True, the value in the text box extends to the limit set by the Columns property, and then wraps to additional rows as necessary. If the Wrap property is False, the value in the text box does not wrap. Additional lines are used only if the text value includes a new-line character. A horizontal scroll bar appears if the value of any line exceeds the limit set by the Columns property.

public virtual bool Wrap { get; set; }

Property Value:

ZeroPadNumericRanges

Gets or sets if the values of numeric range parts of the mask to have a fixed width.

public bool ZeroPadNumericRanges { get; set; }

Property Value:

Enforces the values of numeric range parts of the mask to have a fixed width.

Methods

AddAttributesToRender(HtmlTextWriter)

protected override void AddAttributesToRender(HtmlTextWriter writer)

Parameters:writerHtmlTextWriter

Overrides: RadInputControl.AddAttributesToRender(HtmlTextWriter)

AddParsedSubObject(object)

protected override void AddParsedSubObject(object obj)

Parameters:objobject

Overrides: Control.AddParsedSubObject(object)

DescribeClientEvents(IScriptDescriptor)

protected override void DescribeClientEvents(IScriptDescriptor descriptor)

Parameters:descriptorIScriptDescriptor

Overrides: RadInputControl.DescribeClientEvents(IScriptDescriptor)

DescribeClientProperties(IScriptDescriptor)

protected override void DescribeClientProperties(IScriptDescriptor descriptor)

Parameters:descriptorIScriptDescriptor

Overrides: RadInputControl.DescribeClientProperties(IScriptDescriptor)

DescribeComponent(IScriptDescriptor)

protected override void DescribeComponent(IScriptDescriptor descriptor)

Parameters:descriptorIScriptDescriptor

Overrides: RadInputControl.DescribeComponent(IScriptDescriptor)

IsMultiLine()

protected override bool IsMultiLine()

Returns: