MaskedTextBox.Text MaskedTextBox.Text MaskedTextBox.Text MaskedTextBox.Text Property

定義

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

public:
 virtual property System::String ^ Text { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Bindable(true)]
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.

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

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

Textは、のMaskedTextBox既定のバインディングプロパティです。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プロパティを変更してもMaskイベントはTextChanged発生しませんが、プロパティを変更しても、プロパティは変更されません。For example, changing the PasswordChar property will not raise the TextChanged event, but changing the Mask property will.

適用対象

こちらもご覧ください