情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。

TextBox.MaxLength プロパティ

2013/12/12

ユーザーが入力できる最大文字数を決定する値を取得または設定します。

Namespace:  System.Windows.Controls
アセンブリ:  System.Windows (System.Windows.dll 内)
XAML の XMLNS: xmlns にマップされていません。

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

プロパティ値

型: System.Int32
ユーザーが入力できる文字の最大数。既定値は 0 です。

例外条件
ArgumentOutOfRangeException

設定値が 0 未満です。

ArgumentNullException

設定された値は null です。

依存関係プロパティの識別子フィールド:  MaxLengthProperty.

値 0 を設定した場合は、文字数に制限がないことを示します。

MaxLength を設定すると、ユーザーが入力できる文字数が制限されるだけです。プログラムによる入力は制限されません。プログラムでテキスト ボックスに追加された文字の数が、MaxLength を超える場合は、ユーザーが文字を削除できますが、追加することはできません。文字数が MaxLength より少なくなると、ユーザーは再度テキストを追加できます。

ユーザーは、直前の操作を元に戻すことによって、テキストが MaxLength を超える操作を行うことはできます。

ユーザーがテキスト ボックスにテキストを貼り付けたことによって文字数が MaxLength を超えた場合、テキスト ボックスの末尾から文字が削除されます。

サロゲート文字は、テキスト長判定用には 1 文字と見なされます。

MaxLength プロパティを XAML とコードで使用する方法を次のコード スニペットに示します。


<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

表示: