MaskedTextBox.Text プロパティ


現在ユーザーに表示されているテキストを取得または設定します。Gets or sets the text as it is currently displayed to the user.

 virtual property System::String ^ Text { System::String ^ get(); void set(System::String ^ value); };
public override string Text { get; set; }
member this.Text : string with get, set
Public Overrides Property Text As String


現在コントロールによって表示されているテキストを格納する StringA String containing the text currently displayed by the control. 既定値は空の文字列です。The default is an empty string.


次のコード例は、Text プロパティの使用方法を示しています。The following code example demonstrates the use of the Text property.

Private Sub DisplayText()
    Me.MaskedTextBox1.PasswordChar = CChar("*")

    Me.MaskedTextBox1.Mask = "000-00-0000" ' United States Social Security Number
    Me.MaskedTextBox1.Text = "999999999"

    Debug.WriteLine("MaskedControl.Text: " & Me.MaskedTextBox1.Text) ' Displays: 999-99-9
    Me.MaskedTextBox1.Text = ""

    ' Assigning text.
    Me.MaskedTextBox1.AllowPromptAsInput = True
    Me.MaskedTextBox1.Text = "999-99-9999" ' Works
    Me.MaskedTextBox1.Text = "999999999" ' Works
    Me.MaskedTextBox1.AllowPromptAsInput = False
    'Me.MaskedTextBox1.Text = "999-99-9999" ' Does not work
End Sub


Text は、MaskedTextBox クラスの既定のバインディングプロパティです。Text is the default binding property for the MaskedTextBox class.

このプロパティを使用して取得した文字列は、MaskTextMaskFormatなど、コントロールの書式設定プロパティに従って書式設定されます。Strings retrieved using this property are formatted according to the control's formatting properties, such as Mask and TextMaskFormat.

ResetOnPromptResetOnSpace、および SkipLiteralsの値に応じて、リテラル文字の有無に関係なく文字列を Text に割り当てることができます。You can assign a string with or without literal characters to Text depending on the values of ResetOnPrompt, ResetOnSpace, and SkipLiterals.

TextMaskedTextBoxの既定のバインディングプロパティです。Text is the default binding property for MaskedTextBox.

書式設定されたテキスト値が変更されるたびに、MaskedTextBox によって TextChanged イベントが発生します。MaskedTextBox will raise the TextChanged event whenever the formatted text value changes. プロパティが異なると、この値が変更される可能性があります。Different properties may or may not cause this value to change. たとえば、PasswordChar プロパティを変更しても TextChanged イベントは発生しませんが、Mask プロパティを変更すると、が発生します。For example, changing the PasswordChar property will not raise the TextChanged event, but changing the Mask property will.