MaskedTextBox.Text Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

Pobiera lub ustawia tekst, ponieważ jest on aktualnie wyświetlany użytkownikowi.

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

Wartość właściwości

String

Element String zawierający tekst wyświetlany obecnie przez kontrolkę. Wartość domyślna to pusty ciąg.

Atrybuty
BindableAttribute

Przykłady

Poniższy przykład kodu przedstawia użycie Text właściwości.

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

Uwagi

Text jest domyślną właściwością powiązania dla MaskedTextBox klasy.

Ciągi pobierane przy użyciu tej właściwości są formatowane zgodnie z właściwościami formatowania kontrolki, takimi jak Mask i TextMaskFormat.

Możesz przypisać ciąg z znakami literału lub bez niego w Text zależności od wartości ResetOnPrompt, ResetOnSpacei SkipLiterals.

Text jest domyślną właściwością powiązania dla MaskedTextBoxelementu .

MaskedTextBox będzie zgłaszać TextChanged zdarzenie za każdym razem, gdy zmieni się sformatowana wartość tekstowa. Różne właściwości mogą lub nie mogą spowodować zmiany tej wartości. Na przykład zmiana PasswordChar właściwości nie spowoduje podniesienia TextChanged zdarzenia, ale zmiana Mask właściwości będzie.

Dotyczy

Zobacz też