MaskedTextBox.Text プロパティ

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

MaskedTextBox.Text プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

現在ユーザーに表示されているテキストを取得または設定します。

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

Visual Basic (宣言)

<BindableAttribute(True)> _
<LocalizableAttribute(True)> _
Public Overrides Property
 Text As String

Visual Basic (使用法)

Dim instance As MaskedTextBox
Dim value As String

value = instance.Text

instance.Text = value

C#

[BindableAttribute(true)] 
[LocalizableAttribute(true)] 
public override string Text { get;
 set; }

C++

[BindableAttribute(true)] 
[LocalizableAttribute(true)] 
public:
virtual property String^ Text {
    String^ get () override;
    void set (String^ value) override;
}

J#

/** @property */
public String get_Text ()

/** @property */
public void set_Text (String value)

JScript

public override function get
 Text () : String

public override function set
 Text (value : String)

プロパティ値
現在コントロールによって表示されているテキストを格納する String。既定値は空の文字列です。

解説

Text は、MaskedTextBox クラスの既定のバインディング プロパティです。

このプロパティを使用して取得された文字列は、Mask、TextMaskFormat など、コントロールの書式指定プロパティに従って書式設定されます。

ResetOnPrompt、ResetOnSpace、および SkipLiterals の値に応じて、リテラル文字を使用しても使用しなくても、文字列を Text に割り当てることができます。

Text は、MaskedTextBox の既定のバインディング プロパティです。

書式設定されたテキストの値が変更されるたびに、MaskedTextBox は TextChanged イベントを発生させます。この値が変更されるかどうかは、プロパティによって異なります。たとえば、PasswordChar プロパティを変更しても TextChanged イベントは発生しませんが、Mask プロパティを変更するとイベントが発生します。

使用例

Text プロパティの使用方法を示すコード例を次に示します。

Visual Basic

Private Sub DisplayText()
    Me.MaskedTextBox1.PasswordChar = CChar("*")

    Me.MaskedTextBox1.Mask = "000-00-0000"
 ' United States Social Security Number
    Me.MaskedTextBox1.Text = "999999999"

    Debug.WriteLine("MaskedControl.Text: " & Me.MaskedTextBox1.Text)
 ' Displays: 999-99-9
    Me.MaskedTextBox1.Text = ""

    ' Assigning text.
    Me.MaskedTextBox1.AllowPromptAsInput = True
    Me.MaskedTextBox1.Text = "999-99-9999"
 ' Works
    Me.MaskedTextBox1.Text = "999999999" ' Works
    Me.MaskedTextBox1.AllowPromptAsInput = False
    'Me.MaskedTextBox1.Text = "999-99-9999" ' Does not work
End Sub

プラットフォーム

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

参照

関連項目
MaskedTextBox クラス
MaskedTextBox メンバ
System.Windows.Forms 名前空間
System.ComponentModel.DefaultBindingPropertyAttribute
MaskedTextBox.SelectedText プロパティ
MaskedTextBox.Mask プロパティ
MaskedTextBox.FormatProvider プロパティ
TextMaskFormat
MaskedTextBox.Culture プロパティ
MaskedTextBox.HidePromptOnLeave プロパティ