Compartilhar via


MaskedTextBox.Text Propriedade

Definição

Obtém ou define o texto exibido no momento para o usuário.

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

Valor da propriedade

Um String que contém o texto exibido no momento pelo controle. O padrão é uma cadeia de caracteres vazia.

Atributos

Exemplos

O exemplo de código a seguir demonstra o uso da Text propriedade .

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

Comentários

Text é a propriedade de associação padrão para a MaskedTextBox classe .

As cadeias de caracteres recuperadas usando essa propriedade são formatadas de acordo com as propriedades de formatação do controle, como Mask e TextMaskFormat.

Você pode atribuir uma cadeia de caracteres com ou sem caracteres literais a Text dependendo dos valores de ResetOnPrompt, ResetOnSpacee SkipLiterals.

Text é a propriedade de associação padrão para MaskedTextBox.

MaskedTextBox acionará o TextChanged evento sempre que o valor de texto formatado for alterado. Propriedades diferentes podem ou não fazer com que esse valor seja alterado. Por exemplo, alterar a PasswordChar propriedade não gerará o TextChanged evento, mas alterará a Mask propriedade.

Aplica-se a

Confira também