Freigeben über


MaskedTextBox.Text Eigenschaft

Definition

Ruft den Text ab oder legt ihn fest, wie er derzeit für den Benutzer angezeigt wird.

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

Eigenschaftswert

A String containing the text currently displayed by the control. Der Standardwert ist eine leere Zeichenfolge.

Attribute

Beispiele

Im folgenden Codebeispiel wird die Verwendung der Text Eigenschaft veranschaulicht.

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

Hinweise

Text ist die Standardbindungseigenschaft für die MaskedTextBox Klasse.

Zeichenfolgen, die mithilfe dieser Eigenschaft abgerufen werden, werden entsprechend den Formatierungseigenschaften des Steuerelements formatiert, z Mask . B. und TextMaskFormat.

Sie können eine Zeichenfolge mit oder ohne Literalzeichen Text je nach den Werten von ResetOnPrompt, ResetOnSpaceund SkipLiterals.

Text ist die Standardbindungseigenschaft für MaskedTextBox.

MaskedTextBox löst das TextChanged Ereignis aus, wenn sich der formatierte Textwert ändert. Unterschiedliche Eigenschaften können dazu führen, dass sich dieser Wert ändert. Wenn Sie beispielsweise die PasswordChar Eigenschaft ändern, wird das TextChanged Ereignis nicht ausgelöst, sondern die Mask Eigenschaft geändert.

Gilt für:

Weitere Informationen