TextBoxBase.Modified Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Получает или задает значение, которое показывает, что содержимое элемента управления "Текстовое поле" было изменено пользователем со времени создания элемента управления или последнего ввода его содержимого.

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

Значение свойства

Boolean

Значение true, если содержимое элемента управления изменилось; в противном случае — значение false. Значение по умолчанию — false.

Атрибуты

BrowsableAttribute

Примеры

В следующем примере кода событие используется TextChanged для производного класса , TextBoxчтобы определить, изменилось ли содержимое TextBox элемента управления с момента заполнения элемента управления данными. В примере используется строка для хранения исходного содержимого элемента управления и сравнивается с содержимым TextBox элемента управления , чтобы определить, изменилось ли содержимое. Если содержимое изменилось, свойству Modified присваивается значение true. В противном случае он сбрасывается до false. В этом примере требуется, чтобы TextBox был создан элемент управления с именем textBox1 и была создана переменная String с именем originalText для хранения исходного TextBox текста элемента управления.

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

Комментарии

Это свойство можно использовать, чтобы определить, изменил ли пользователь содержимое элемента управления "Текстовое поле". Это свойство также можно задать в коде, чтобы указать, что приложением были внесены изменения в элемент управления "Текстовое поле". Это свойство может использоваться методами проверки и сохранения данных, чтобы определить, были ли внесены изменения в элементе управления "Текстовое поле", чтобы можно было проверить или сохранить измененное содержимое.

Если изменить свойство программным способом Text , Modified свойство возвращается к false. Это не приводит к возникновению ModifiedChanged события.