MaskedTextBox.Text Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft den Text ab, wie er gerade angezeigt wird, oder legt diesen fest.

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

String

Eine String, die den momentan durch das Steuerelement angezeigten Text enthält. Der Standardwert ist eine leere Zeichenfolge.

Attribute: BindableAttribute

Beispiele

Im folgenden Codebeispiel wird die Verwendung des Text-Attributs 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 mit dieser Eigenschaft abgerufen werden, werden entsprechend den Formatierungseigenschaften des Steuerelements formatiert, z Mask . B. und TextMaskFormat.

Abhängig von den Werten von ResetOnPrompt, ResetOnSpace SkipLiteralsund können Sie eine Zeichenfolge mit oder ohne Literalzeichen Text zuweisen.

Text ist die Standardbindungseigenschaft für MaskedTextBox.

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

Gilt für:

Freigeben über