MaskedTextBox.Text Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtient ou définit le texte tel qu'il est présenté actuellement à l'utilisateur.

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

Valeur de propriété

String

String contenant le texte actuellement affiché par le contrôle. La valeur par défaut est une chaîne vide.

Attributs

BindableAttribute

Exemples

L’exemple de code suivant illustre l’utilisation de la Text propriété .

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

Remarques

Text est la propriété de liaison par défaut pour la MaskedTextBox classe .

Les chaînes récupérées à l’aide de cette propriété sont mises en forme en fonction des propriétés de mise en forme du contrôle, telles que Mask et TextMaskFormat.

Vous pouvez affecter une chaîne avec ou sans caractères littéraux à Text en fonction des valeurs de ResetOnPrompt, ResetOnSpaceet SkipLiterals.

Text est la propriété de liaison par défaut pour MaskedTextBox.

MaskedTextBox déclenche l’événement TextChanged chaque fois que la valeur du texte mis en forme change. Des propriétés différentes peuvent entraîner ou non la modification de cette valeur. Par exemple, la modification de la PasswordChar propriété ne déclenche pas l’événement TextChanged , mais la modification de la Mask propriété.

Voir aussi

• DefaultBindingPropertyAttribute
• SelectedText
• Mask
• FormatProvider
• TextMaskFormat
• Culture
• HidePromptOnLeave