TextBoxBase.Modified Свойство

Определение

Получает или задает значение, которое показывает, что содержимое элемента управления "Текстовое поле" было изменено пользователем со времени создания элемента управления или последнего ввода его содержимого.Gets or sets a value that indicates that the text box control has been modified by the user since the control was created or its contents were last set.

public:
 property bool Modified { bool get(); void set(bool value); };
[System.ComponentModel.Browsable(false)]
public bool Modified { get; set; }
member this.Modified : bool with get, set
Public Property Modified As Boolean

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

Значение true, если содержимое элемента управления изменилось; в противном случае — значение false.true if the control's contents have been modified; otherwise, false. Значение по умолчанию — false.The default is false.

Атрибуты

Примеры

В следующем примере кода используется TextChanged событие TextBoxдля производного класса, чтобы определить, изменилось TextBox ли содержимое элемента управления с момента заполнения элементом управления данных.The following code example uses the TextChanged event for a TextBox, a derived class, to determine if the contents of the TextBox control have changed since the control was filled with data. В примере используется строка для хранения исходного содержимого элемента управления и сравнивается с содержимым, TextBox чтобы определить, изменилось ли содержимое.The example uses a string to store the original contents of the control and compares it against the contents of the TextBox to determine if the contents have changed. Если содержимое изменилось, Modified свойство устанавливается в trueзначение.If the contents have changed, the Modified property is set to true. В противном случае он сбрасывается в false.Otherwise, it is reset to false. В этом примере требуется, TextBox чтобы был textBox1 создан элемент управления с именем и String была создана originalText переменная с именем для хранения исходного текста TextBox элемента управления.This example requires that a TextBox control named textBox1 has been created and that a String variable named originalText has been created to store the original text for the TextBox control.

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

Комментарии

С помощью этого свойства можно определить, изменил ли пользователь содержимое элемента управления "текстовое поле".You can use this property to determine if the user has modified the contents of the text box control. Это свойство также можно задать в коде, чтобы указать, что приложение выполнило изменения в элементе управления "текстовое поле".You can also set this property in code to indicate that changes were made to the text box control by the application. Это свойство может использоваться методами проверки и сохранения данных, чтобы определить, были ли внесены изменения в элементе управления "текстовое поле", чтобы измененное содержимое можно было проверить или сохранить.This property can be used by validation and data-saving methods to determine if changes were made in a text box control so the changed contents can be validated or saved.

Если изменить Text свойство программно Modified , свойство вернется к false.If you change the Text property programmatically, the Modified property reverts to false. Это не вызывает ModifiedChanged событие.This does not raise the ModifiedChanged event.

Применяется к