TextBoxBase.Modified Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Pobiera lub ustawia wartość wskazującą, że kontrolka pola tekstowego została zmodyfikowana przez użytkownika, ponieważ kontrolka została utworzona lub jej zawartość została ostatnio ustawiona.

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

Wartość właściwości

Boolean

true jeśli zawartość kontrolki została zmodyfikowana; w przeciwnym razie , false. Wartość domyślna to false.

Atrybuty

BrowsableAttribute

Przykłady

Poniższy przykład kodu używa TextChanged zdarzenia dla TextBoxklasy pochodnej , aby określić, czy zawartość TextBox kontrolki uległa zmianie od momentu wypełnienia kontrolki danymi. W przykładzie użyto ciągu do przechowywania oryginalnej zawartości kontrolki i porównywania jej z zawartością obiektu w TextBox celu określenia, czy zawartość została zmieniona. Jeśli zawartość została zmieniona, właściwość jest ustawiona Modified na true. W przeciwnym razie jest resetowany do falseelementu . Ten przykład wymaga TextBox utworzenia kontrolki o nazwie i String utworzenia zmiennej o nazwie textBox1originalText do przechowywania oryginalnego tekstu kontrolkiTextBox.

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

Uwagi

Tej właściwości można użyć do określenia, czy użytkownik zmodyfikował zawartość kontrolki pola tekstowego. Tę właściwość można również ustawić w kodzie, aby wskazać, że zmiany zostały wprowadzone w kontrolce pola tekstowego przez aplikację. Ta właściwość może być używana przez metody walidacji i zapisywania danych w celu określenia, czy zmiany zostały wprowadzone w kontrolce pola tekstowego, aby można było zweryfikować lub zapisać zmienioną zawartość.

Jeśli właściwość zostanie zmieniona Text programowo, Modified właściwość zostanie przywrócona do false. Nie powoduje to wystąpienia ModifiedChanged zdarzenia.