TextBoxBase.Modified プロパティ

.NET Framework クラス ライブラリ リファレンス

TextBoxBase.Modified プロパティ

コントロールが作成されてから、またはコントロールが最後に設定されてから、ユーザーがテキスト ボックス コントロールを変更したかどうかを示す値を取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Property Modified As
 Boolean

Visual Basic (使用法)

Dim instance As TextBoxBase
Dim value As Boolean

value = instance.Modified

instance.Modified = value

C#

public bool Modified { get;
 set; }

C++

public:
property bool Modified {
    bool get ();
    void set (bool value);
}

J#

/** @property */
public boolean get_Modified ()

/** @property */
public void set_Modified (boolean value)

JScript

public function get Modified
 () : boolean

public function set Modified
 (value : boolean)

プロパティ値
コントロールの内容が変更された場合は true。それ以外の場合は false。既定値は false です。

解説

このプロパティを使用すると、ユーザーがテキスト ボックス コントロールの内容を変更したかどうかを判断できます。また、このプロパティをコードで使用すると、アプリケーションでテキスト ボックス コントロールに変更が加えられたかどうかを判断することもできます。テキスト ボックス コントロールで変更が加えられたかどうかを判断するために、このプロパティを validation メソッドおよび data-saving メソッドで使用すると、変更された内容を検証または保存できます。

使用例

派生クラス TextBox の TextChanged イベントを使用して、コントロールにデータが入力されてから TextBox コントロールの内容が変更されたかどうかを判断するコード例を次に示します。この例では、コントロールの元の内容を格納している文字列を使用して、その文字列と TextBox の内容を比較し、内容が変更されたかどうかを判断します。内容が変更された場合は、Modified プロパティが true に設定されます。それ以外の場合は false にリセットされます。この例では、textBox1 という名前の TextBox コントロールが作成されており、TextBox コントロールの元のテキストを格納するために originalText という名前の String 変数が作成されている必要があります。

Visual Basic

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

C#

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;
 }
 

C++

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;
      }
   }

J#

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.Equals(textBox1.get_Text()))) {
        // Set the Modified property to true to reflect the change.
        textBox1.set_Modified(true);
    }
    else {
        // Contents of textBox1 have not changed,
        // reset the Modified property.
        textBox1.set_Modified(false);
    }
} //TextBox1_TextChanged 

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
TextBoxBase クラス
TextBoxBase メンバ
System.Windows.Forms 名前空間