TextBoxBase.Modified Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft einen Wert ab, der angibt, dass das Textfeld-Steuerelement seit dem Erstellen oder der letzten Festlegung des Inhalts von Benutzern geändert wurde, oder legt diesen fest.

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

Eigenschaftswert

Boolean

true, wenn der Inhalt des Steuerelements geändert wurde, andernfalls false. Der Standardwert ist false.

Attribute

BrowsableAttribute

Beispiele

Im folgenden Codebeispiel wird das TextChanged -Ereignis für eine TextBoxabgeleitete Klasse verwendet, um zu bestimmen, ob sich der Inhalt des TextBox Steuerelements geändert hat, seit das Steuerelement mit Daten gefüllt wurde. Im Beispiel wird eine Zeichenfolge verwendet, um den ursprünglichen Inhalt des Steuerelements zu speichern, und vergleicht ihn mit dem Inhalt von, TextBox um festzustellen, ob sich der Inhalt geändert hat. Wenn sich der Inhalt geändert hat, wird die Modified -Eigenschaft auf truefestgelegt. Andernfalls wird sie auf falsezurückgesetzt. Dieses Beispiel erfordert, dass ein TextBox Steuerelement mit dem Namen textBox1 erstellt wurde und dass eine String Variable mit dem Namen originalText erstellt wurde, um den ursprünglichen Text für das TextBox Steuerelement zu speichern.

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

Hinweise

Sie können diese Eigenschaft verwenden, um zu bestimmen, ob der Benutzer den Inhalt des Textfeld-Steuerelements geändert hat. Sie können diese Eigenschaft auch im Code festlegen, um anzugeben, dass die Anwendung Änderungen am Textfeld-Steuerelement vorgenommen hat. Diese Eigenschaft kann von Validierungs- und Datenspeichermethoden verwendet werden, um zu bestimmen, ob Änderungen in einem Textfeld-Steuerelement vorgenommen wurden, damit der geänderte Inhalt überprüft oder gespeichert werden kann.

Wenn Sie die Text Eigenschaft programmgesteuert ändern, wird die Modified -Eigenschaft auf falsezurückgesetzt. Dadurch wird das ModifiedChanged Ereignis nicht ausgelöst.