MaskedTextBox.Text Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 contenant le texte actuellement affiché par le contrôle. La valeur par défaut est une chaîne vide.
- Attributs
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é.