导出 (0) 打印
全部展开
信息
您所需的主题如下所示。但此主题未包含在此库中。

TextBox.MaxLength 属性

2013/12/13

获取或设置一个值,该值确定用户输入所允许的最大字符数。

Namespace:  System.Windows.Controls
程序集:  System.Windows(位于 System.Windows.dll 中)
XMLNS for XAML: 未映射到 xmlns。

public int MaxLength { get; set; }
<TextBox MaxLength="int"/>

属性值

类型: System.Int32
用户输入允许的最大字符数。 默认值为 0。

异常条件
ArgumentOutOfRangeException

所设置的值小于 0。

ArgumentNullException

该值设置为 null

依赖项属性标识符字段: MaxLengthProperty.

如果将值设置为 0,则指示对于字符数不存在任何限制。

设置 MaxLength 仅限制用户可以输入的字符数。 它不限制以编程方式进行的输入。 如果以编程方式添加到文本框中的字符数大于 MaxLength,则用户可以删除字符,但不能添加任何字符。 一旦字符数小于 MaxLength,则用户可以再次添加文本。

用户可以撤消先前的操作并使文本超过 MaxLength

如果用户粘贴到文本框中的文本导致字符数超出 MaxLength,则删除文本框中位于最后的若干字符。

代理项字符被视为一个字符用于确定文本长度。

下面的代码段演示如何可以在 XAML 和代码中使用 MaxLength 属性。


<StackPanel>
    <TextBox Margin="20,20,0,0" Text="A text box that demonstrates TextWrapping, TextAlignment, MaxLength, and AcceptsReturn" 
             Width="300" Height="150" TextWrapping="Wrap" TextAlignment="Center" MaxLength="500" AcceptsReturn="True" />
    <TextBox Margin="20,20,0,0" Text="A text box that demonstrates HorizontalScrollBarVisibility and VerticalScrollBarVisibility" 
             Width="300" Height="150" AcceptsReturn="True" HorizontalScrollBarVisibility="Visible" VerticalScrollBarVisibility="Visible" />
</StackPanel>



public Page()
{
    InitializeComponent();
    CreateControls();
}

private void CreateControls()
{
    //Create stack panel
    StackPanel MyStackPanel = new StackPanel();

    //Create the first text box
    TextBox MyTB1 = new TextBox();
    MyTB1.Width = 300;
    MyTB1.Height = 150;
    MyTB1.Text = "A text box that demonstrates TextWrapping, TextAlignment, MaxLength and AcceptsReturn";
    MyTB1.TextWrapping = TextWrapping.Wrap;
    MyTB1.TextAlignment = TextAlignment.Center;
    MyTB1.MaxLength = 500;
    MyTB1.AcceptsReturn = true;
    MyTB1.Margin = new Thickness(20, 20, 0, 0);

    //Create the second text box
    TextBox MyTB2 = new TextBox();
    MyTB2.Margin = new Thickness(20, 20, 0, 0);
    MyTB2.Text = "A text box that demonstrates HorizontalScrollBarVisibility and VerticalScrollBarVisibility";
    MyTB2.Width = 300;
    MyTB2.Height = 150;
    MyTB2.AcceptsReturn = true;
    MyTB2.HorizontalScrollBarVisibility = ScrollBarVisibility.Visible;
    MyTB2.VerticalScrollBarVisibility = ScrollBarVisibility.Visible;

    //Add the text boxes to the stack panel
    MyStackPanel.Children.Add(MyTB1);
    MyStackPanel.Children.Add(MyTB2);
    this.Content = MyStackPanel;
}


Windows Phone OS

受以下版本支持: 8.0, 7.1, 7.0

Windows Phone

Microsoft 正在进行一项网上调查,以了解您对 MSDN 网站的意见。 如果您选择参加,我们将会在您离开 MSDN 网站时向您显示该网上调查。

是否要参加?
显示:
© 2014 Microsoft