TextBoxBase.Modified プロパティ
コントロールが作成されてから、またはコントロールが最後に設定されてから、ユーザーがテキスト ボックス コントロールを変更したかどうかを示す値を取得または設定します。
名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文
'宣言
Public Property Modified As Boolean
'使用
Dim instance As TextBoxBase
Dim value As Boolean
value = instance.Modified
instance.Modified = value
public bool Modified { get; set; }
public:
property bool Modified {
bool get ();
void set (bool value);
}
/** @property */
public boolean get_Modified ()
/** @property */
public void set_Modified (boolean value)
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 変数が作成されている必要があります。
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
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 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