Freigeben über


TextBoxBase.Modified Eigenschaft

Definition

Dient zum Abrufen oder Festlegen eines Werts, der angibt, dass das Textfeld-Steuerelement vom Benutzer geändert wurde, seit das Steuerelement erstellt wurde oder sein Inhalt zuletzt festgelegt wurde.

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

truewenn der Inhalt des Steuerelements geändert wurde; andernfalls . false Der Standardwert lautet false.

Attribute

Beispiele

Im folgenden Codebeispiel wird das TextChanged Ereignis für eine TextBoxabgeleitete Klasse verwendet, um festzustellen, ob sich der Inhalt des TextBox Steuerelements seit dem Ausfüllen des Steuerelements mit Daten geändert hat. Im Beispiel wird eine Zeichenfolge verwendet, um den ursprünglichen Inhalt des Steuerelements zu speichern und mit dem Inhalt des TextBox Steuerelements zu vergleichen, um festzustellen, ob sich der Inhalt geändert hat. Wenn sich der Inhalt geändert hat, wird die Modified Eigenschaft auf true. Andernfalls wird sie auf false. Dieses Beispiel erfordert, dass ein benanntes TextBoxtextBox1 Steuerelement erstellt wurde und 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

Mit dieser Eigenschaft können Sie ermitteln, ob der Benutzer den Inhalt des Textfeld-Steuerelements geändert hat. Sie können diese Eigenschaft auch im Code festlegen, um anzugeben, dass Änderungen am Textfeld-Steuerelement von der Anwendung vorgenommen wurden. 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 wiederhergestellt.false Dadurch wird das ModifiedChanged Ereignis nicht ausgelöst.

Gilt für: