TextBoxBase.Modified TextBoxBase.Modified TextBoxBase.Modified TextBoxBase.Modified Property

Definición

Obtiene o establece un valor que indica que el control de cuadro de texto se ha modificado por el usuario desde que se creó el control o establecer su contenido por última vez.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

Valor de propiedad

true Si se ha modificado el contenido del control; en caso contrario, false.true if the control's contents have been modified; otherwise, false. De manera predeterminada, es false.The default is false.

Ejemplos

El siguiente ejemplo de código utiliza el TextChanged eventos para un TextBox, una clase derivada, para determinar si el contenido de la TextBox control han cambiado desde que el control se rellenó con datos.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. En el ejemplo se utiliza una cadena para almacenar el contenido original del control y se compara con el contenido de la TextBox para determinar si el contenido ha cambiado.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. Si ha cambiado el contenido, el Modified propiedad está establecida en true.If the contents have changed, the Modified property is set to true. En caso contrario, se restablece en false.Otherwise, it is reset to false. Este ejemplo requiere que un TextBox control denominado textBox1 se ha creado y que un String variable denominada originalText se ha creado para almacenar el texto original para el TextBox control.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

Comentarios

Puede utilizar esta propiedad para determinar si el usuario ha modificado el contenido del control de cuadro de texto.You can use this property to determine if the user has modified the contents of the text box control. También puede establecer esta propiedad en el código para indicar que se realizaron cambios en el control de cuadro de texto por la aplicación.You can also set this property in code to indicate that changes were made to the text box control by the application. Esta propiedad puede utilizarse por métodos de almacenamiento de datos y validación para determinar si se realizaron cambios en un control de cuadro de texto, por lo que puede ser validado o guardar el contenido cambiado.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.

Si cambia el Text propiedad mediante programación, el Modified propiedad vuelve a false.If you change the Text property programmatically, the Modified property reverts to false. Esto no provoca la ModifiedChanged eventos.This does not raise the ModifiedChanged event.

Se aplica a