(0) exportieren Drucken
Alle erweitern

TextBoxBase.Modified-Eigenschaft

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.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

public bool Modified { get; set; }
/** @property */
public boolean get_Modified ()

/** @property */
public void set_Modified (boolean value)

public function get Modified () : boolean

public function set Modified (value : boolean)

Eigenschaftenwert

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

Sie können mit dieser Eigenschaft bestimmen, ob der Inhalt des Textfeld-Steuerelements durch Benutzer geändert wurde. Sie können diese Eigenschaft auch im Code festlegen, um anzugeben, dass das Textfeld-Steuerelement durch die Anwendung geändert wurde. Diese Eigenschaft kann von Methoden für die Validierung und Datenspeicherung verwendet werden, um zu bestimmen, ob in einem Textfeld-Steuerelement Änderungen vorgenommen wurden, sodass der geänderte Inhalt geprüft oder gespeichert werden kann.

Im folgenden Codebeispiel wird mithilfe des TextChanged-Ereignisses für die abgeleitete Klasse TextBox bestimmt, ob der Inhalt des TextBox-Steuerelements seit dem Eintragen der Daten in das Steuerelement geändert wurde. Im Beispiel wird der ursprüngliche Inhalt des Steuerelements in einer Zeichenfolge gespeichert und mit dem Inhalt von TextBox verglichen, um zu bestimmen, ob der Inhalt geändert wurde. Wenn der Inhalt geändert wurde, wird die Modified-Eigenschaft auf true festgelegt. Andernfalls wird sie auf false zurückgesetzt. In diesem Beispiel ist es erforderlich, dass ein TextBox-Steuerelement mit dem Namen textBox1 und die String-Variable originalText erstellt wurden, 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.Equals(textBox1.get_Text()))) {
        // Set the Modified property to true to reflect the change.
        textBox1.set_Modified(true);
    }
    else {
        // Contents of textBox1 have not changed,
        // reset the Modified property.
        textBox1.set_Modified(false);
    }
} //TextBox1_TextChanged 

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0
Anzeigen:
© 2014 Microsoft