TextBoxBase.Modified Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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.

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. Il valore predefinito è false.

Attributi

BrowsableAttribute

Esempio

Nell'esempio di codice seguente viene usato l'evento TextChanged per una TextBoxclasse derivata, per determinare se il contenuto del TextBox controllo è stato modificato dopo che il controllo è stato riempito con dati. L'esempio usa una stringa per archiviare il contenuto originale del controllo e lo confronta con il contenuto dell'oggetto TextBox per determinare se il contenuto è stato modificato. Se il contenuto è stato modificato, la Modified proprietà è impostata su true. In caso contrario, viene reimpostato su false. Questo esempio richiede che sia stato creato un controllo denominato textBox1 e che sia stata creata una TextBoxString variabile denominata originalText per archiviare il testo originale per il TextBox controllo.

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 usare questa proprietà per determinare se l'utente ha modificato il contenuto del controllo casella di testo. È anche possibile impostare questa proprietà nel codice per indicare che sono state apportate modifiche al controllo casella di testo dall'applicazione. Questa proprietà può essere usata dai metodi di convalida e salvataggio dei dati per determinare se le modifiche sono state apportate in un controllo casella di testo in modo che il contenuto modificato possa essere convalidato o salvato.

Se si modifica la proprietà a livello di codice, la TextModified proprietà viene ripristinata su false. Questa operazione non genera l'evento ModifiedChanged .