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

定義

コントロールが作成されてから、またはコントロールが最後に設定されてから、ユーザーがテキスト ボックス コントロールを変更したかどうかを示す値を取得または設定します。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。それ以外の場合は falsetrue 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.

適用対象