TextBoxBase.Modified Propriété

Définition

Obtient ou définit une valeur qui indique que le contrôle zone de texte a été modifié par l'utilisateur depuis la création du contrôle ou la précédente définition du contenu du contrôle.Gets or sets a value that indicates that the text box control has been modified by the user since the control was created or its contents were last set.

public:
 property bool Modified { bool get(); void set(bool value); };
[System.ComponentModel.Browsable(false)]
public bool Modified { get; set; }
member this.Modified : bool with get, set
Public Property Modified As Boolean

Valeur de propriété

true si le contenu du contrôle a été modifié ; sinon, false.true if the control's contents have been modified; otherwise, false. La valeur par défaut est false.The default is false.

Attributs

Exemples

L’exemple de code suivant utilise TextChanged l’événement pour TextBoxune classe dérivée, pour déterminer TextBox si le contenu du contrôle a été modifié depuis que le contrôle a été rempli de données.The following code example uses the TextChanged event for a TextBox, a derived class, to determine if the contents of the TextBox control have changed since the control was filled with data. L’exemple utilise une chaîne pour stocker le contenu d’origine du contrôle et le compare au contenu du TextBox pour déterminer si le contenu a changé.The example uses a string to store the original contents of the control and compares it against the contents of the TextBox to determine if the contents have changed. Si le contenu a changé, la Modified propriété a la truevaleur.If the contents have changed, the Modified property is set to true. Dans le cas contraire, elle falseest réinitialisée à.Otherwise, it is reset to false. Cet exemple requiert qu’un TextBox contrôle nommé textBox1 ait été créé et qu’une String variable nommée originalText ait été créée pour stocker le texte TextBox d’origine du contrôle.This example requires that a TextBox control named textBox1 has been created and that a String variable named originalText has been created to store the original text for the TextBox control.

private:
   void TextBox1_TextChanged( Object^ sender, EventArgs^ e )
   {
      /* Check to see if the change made does not return the
         control to its original state. */
      if ( originalText != textBox1->Text )
      {
         // Set the Modified property to true to reflect the change.
         textBox1->Modified = true;
      }
      else
      {
         // Contents of textBox1 have not changed, reset the Modified property.
         textBox1->Modified = false;
      }
   }
private void TextBox1_TextChanged(object sender, EventArgs e)
 {
    /* Check to see if the change made does not return the
       control to its original state. */
    if (originalText != textBox1.Text)
       // Set the Modified property to true to reflect the change.
       textBox1.Modified = true;
    else
       // Contents of textBox1 have not changed, reset the Modified property.
       textBox1.Modified = false;
 }
 
Private Sub TextBox1_TextChanged(sender As Object, e As EventArgs)
    ' Check to see if the change made does not return the
    ' control to its original state. 
    If originalText <> textBox1.Text Then
        ' Set the Modified property to true to reflect the change.
        textBox1.Modified = True
        ' Contents of textBox1 have not changed, reset the Modified property.
    Else
        textBox1.Modified = False
    End If
End Sub

Remarques

Vous pouvez utiliser cette propriété pour déterminer si l’utilisateur a modifié le contenu du contrôle zone de texte.You can use this property to determine if the user has modified the contents of the text box control. Vous pouvez également définir cette propriété dans le code pour indiquer que l’application a apporté des modifications au contrôle de zone de texte.You can also set this property in code to indicate that changes were made to the text box control by the application. Cette propriété peut être utilisée par les méthodes de validation et d’enregistrement des données pour déterminer si des modifications ont été apportées dans un contrôle de zone de texte afin que le contenu modifié puisse être validé ou enregistré.This property can be used by validation and data-saving methods to determine if changes were made in a text box control so the changed contents can be validated or saved.

Si vous modifiez la Text propriété par programmation, la Modified propriété revient à false.If you change the Text property programmatically, the Modified property reverts to false. Cela ne déclenche pas l' ModifiedChanged événement.This does not raise the ModifiedChanged event.

S’applique à