TextBoxBase.Modified Proprietà

Definizione

Ottiene o imposta un valore indicante che il controllo casella di testo è stato modificato dall'ultima volta che il controllo è stato creato o è stato impostato il relativo contenuto.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; }
[<System.ComponentModel.Browsable(false)>]
member this.Modified : bool with get, set
Public Property Modified As Boolean

Valore della proprietà

Boolean

true se il contenuto del controllo è stato modificato; in caso contrario, false.true if the control's contents have been modified; otherwise, false. Il valore predefinito è false.The default is false.

Attributi

Esempio

Nell'esempio di codice seguente viene usato l' TextChanged evento per un oggetto TextBox , una classe derivata, per determinare se il contenuto del TextBox controllo è stato modificato dopo che il controllo è stato riempito con i dati.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. Nell'esempio viene utilizzata una stringa per archiviare il contenuto originale del controllo e viene confrontato con il contenuto di TextBox per determinare se il contenuto è stato modificato.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. Se il contenuto è stato modificato, la Modified proprietà viene impostata su true .If the contents have changed, the Modified property is set to true. In caso contrario, viene reimpostato su false .Otherwise, it is reset to false. Questo esempio richiede che TextBox textBox1 sia stato creato un controllo denominato e che String sia stata creata una variabile denominata originalText per archiviare il testo originale per il TextBox controllo.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

Commenti

È possibile utilizzare questa proprietà per determinare se l'utente ha modificato il contenuto del controllo casella di testo.You can use this property to determine if the user has modified the contents of the text box control. È inoltre possibile impostare questa proprietà nel codice per indicare che l'applicazione ha apportato modifiche al controllo casella di testo.You can also set this property in code to indicate that changes were made to the text box control by the application. Questa proprietà può essere utilizzata dai metodi di convalida e di salvataggio dei dati per determinare se sono state apportate modifiche in un controllo casella di testo in modo che il contenuto modificato possa essere convalidato o salvato.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.

Se si modifica la Text proprietà a livello di codice, la Modified proprietà viene ripristinata false .If you change the Text property programmatically, the Modified property reverts to false. Questa operazione non genera l' ModifiedChanged evento.This does not raise the ModifiedChanged event.

Si applica a