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 事件。