TextBoxBase.Modified Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Obtiene o establece un valor que indica que el usuario ha modificado el control de cuadro de texto desde que se creó el control o se estableció su contenido por última vez.

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

Valor de propiedad

Boolean

true si se ha modificado el contenido del control; en caso contrario, false. De manera predeterminada, es false.

Atributos

BrowsableAttribute

Ejemplos

En el ejemplo de código siguiente se usa el TextChanged evento para , TextBoxuna clase derivada, para determinar si el contenido del TextBox control ha cambiado desde que el control se ha rellenado con datos. En el ejemplo se usa una cadena para almacenar el contenido original del control y compararlo con el contenido de TextBox para determinar si el contenido ha cambiado. Si el contenido ha cambiado, la Modified propiedad se establece trueen . De lo contrario, se restablece a false. En este ejemplo se requiere que se haya creado un TextBox control denominado textBox1 y que se haya creado una String variable denominada originalText para almacenar el texto original del 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

Comentarios

Puede usar esta propiedad para determinar si el usuario ha modificado el contenido del control de cuadro de texto. También puede establecer esta propiedad en el código para indicar que la aplicación realizó cambios en el control de cuadro de texto. Esta propiedad se puede usar mediante métodos de validación y guardado de datos para determinar si se realizaron cambios en un control de cuadro de texto para que el contenido modificado se pueda validar o guardar.

Si cambia la Text propiedad mediante programación, la Modified propiedad se revierte a false. Esto no genera el ModifiedChanged evento .