Atlas学习手记（17）：使用FilteredTextBox过滤字符

FilteredTextBox Extender可以过滤TextBox中用户输入的不合法字符，使用JavaScript和验证控件来检测时一般都是在用户输入之后再去判断是否合法，使用FilteredTextBox则可以直接阻止不让用户输入不合法的字符，也避免了将数据传入到服务端的时候再去验证。

主要内容

1．FilteredTextBox介绍

2．完整示例

一．FilteredTextBox介绍

FilteredTextBox Extender可以过滤TextBox中用户输入的不合法字符，使用JavaScript和验证控件来检测时一般都是在用户输入之后再去判断是否合法，使用FilteredTextBox则可以直接阻止不让用户输入不合法的字符，也避免了将数据传入到服务端的时候再去验证。示例代码如下：

<atlasToolkit:FilteredTextBoxExtender ID="ftbe" runat="server">

    <atlasToolkit:FilteredTextBoxProperties 

        TargetControlID="TextBox3" 

        FilterType="Custom, Numbers"

        ValidChars="+-=/*()." />

</atlasToolkit:FilteredTextBoxExtender>

它的属性如下：

属性	描述
TargetControlID	要进行过滤的目标TextBox的ID
FilterType	字符过滤类型，提供的有如下四种：Numbers，LowercaseLetters，UppercaseLetters，Custom他们之间可以同时指定多个类型，如： FilterType="Custom, Numbers"
ValidChars	当FilterType为Custom时允许输入的字符，否则将被忽略 ValidChars="+-=/*()."

二．完整示例

FilteredTextBox Extender的使用非常简单，下面看一个完整的示例。新建一个WebSite后，在ASPX页面的顶部加入：

<%@ Register Assembly="AtlasControlToolkit" 

            Namespace="AtlasControlToolkit" 

            TagPrefix="atlasToolkit" %>

在页面上添加三个TextBox，分别做三种不同的过滤：

<div>

    <table border="0">

        <tr>

            <td>

                只能输入数字：</td>

            <td>

                <asp:TextBox ID="TextBox1" runat="server" />

            </td>

        </tr>

        <tr>

            <td>

                只能输入小写字母：</td>

            <td>

                <asp:TextBox ID="TextBox2" runat="server" /></td>

        </tr>

        <tr>

            <td>

                只能输入符号(+,-,*,/,=,.)和数字：</td>

            <td>

                <asp:TextBox ID="TextBox3" runat="server"></asp:TextBox></td>

        </tr>

    </table>
</div>

添加FilteredTextBoxExtender，对每一个TextBox都要添加FilteredTextBoxProperties，设置参数如下：

<atlasToolkit:FilteredTextBoxExtender ID="ftbe" runat="server">

    <atlasToolkit:FilteredTextBoxProperties 

        TargetControlID="TextBox1" 

        FilterType="Numbers"/>

    <atlasToolkit:FilteredTextBoxProperties 

        TargetControlID="TextBox2" 

        FilterType="LowercaseLetters" />

    <atlasToolkit:FilteredTextBoxProperties 

        TargetControlID="TextBox3" 

        FilterType="Custom, Numbers"

        ValidChars="+-=/*()." />

</atlasToolkit:FilteredTextBoxExtender>

运行后如下：

输入字符，可以看到在第一个TextBox中不可以输入字母和符号，第二个TextBox只可以输入小写字母：

完整的示例下载