MaskedTextBox.PasswordChar プロパティ

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

MaskedTextBox.PasswordChar プロパティ

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

ユーザー入力の代わりに表示される文字を取得または設定します。

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

Visual Basic (宣言)

Public Property PasswordChar As
 Char

Visual Basic (使用法)

Dim instance As MaskedTextBox
Dim value As Char

value = instance.PasswordChar

instance.PasswordChar = value

C#

public char PasswordChar { get;
 set; }

C++

public:
property wchar_t PasswordChar {
    wchar_t get ();
    void set (wchar_t value);
}

J#

/** @property */
public char get_PasswordChar ()

/** @property */
public void set_PasswordChar (char
 value)

JScript

public function get PasswordChar
 () : char

public function set PasswordChar
 (value : char)

プロパティ値
パスワード文字として使用される Char 値。

例外

例外の種類	条件
ArgumentException	このプロパティの設定時に指定された文字が、MaskedTextProvider クラスの IsValidPasswordChar メソッドで決定された有効なパスワード文字ではありません。
InvalidOperationException	指定されたパスワード文字が、現在のプロンプト文字 PromptChar と同じです。2 つの文字は異なっている必要があります。

解説

重要なユーザー入力の場合、通常はユーザーが入力する実際の情報を非表示にします。PasswordChar プロパティが null 以外の文字に設定されている場合、MaskedTextBox は、コントロールへのすべての入力に対してこの文字を表示します。このプロパティを null 参照 (Visual Basic では Nothing) に設定すると、この機能は無効になります。

オペレーティング システムが提供するパスワード文字を使用する場合は、UseSystemPasswordChar プロパティを使用します。PasswordChar プロパティと UseSystemPasswordChar プロパティの両方がアクティブにされている場合は、後者が優先されます。

重要 :
セキュリティ上の懸念により、MaskedTextBox コントロールは、パスワードで保護された文字列に関する切り取りおよびコピー操作を無効にします。

プラットフォーム

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 名前空間
UseSystemPasswordChar
MaskedTextBox.Mask プロパティ
PromptChar