TextBox.CharacterCasing プロパティ

TextBox コントロールで入力された文字の大文字と小文字を変更するかどうかを取得または設定します。

Public Property CharacterCasing As CharacterCasing
[C#]
public CharacterCasing CharacterCasing {get; set;}
[C++]
public: __property CharacterCasing get_CharacterCasing();public: __property void set_CharacterCasing(CharacterCasing);
[JScript]
public function get CharacterCasing() : CharacterCasing;public function set CharacterCasing(CharacterCasing);

プロパティ値

TextBox コントロールで大文字と小文字を変更するかどうかを指定する CharacterCasing 列挙値の 1 つ。既定値は CharacterCasing.Normal です。

例外

例外の種類	条件
InvalidEnumArgumentException	列挙体の有効値の範囲内にない値が、プロパティに代入されました。

解説

CharacterCasing プロパティを使用して、アプリケーションの必要に応じて文字の大文字と小文字を変更できます。たとえば、パスワードの入力に使用される TextBox コントロールに入力されたすべての文字を大文字または小文字に変更して、パスワードのポリシーを適用できます。

使用例

パスワードを受け入れるために使用される TextBox コントロールを作成する例を次に示します。この例では、 CharacterCasing プロパティを使用して、入力されたすべての文字を大文字に変更します。また、 MaxLength プロパティを使用して、パスワード長を 8 文字に制限します。この例では、 TextAlign プロパティも使用して、 TextBox コントロールの中央にパスワードを配置します。

 
Public Sub CreateMyPasswordTextBox()
    ' Create an instance of the TextBox control.
    Dim textBox1 As New TextBox()
    ' Set the maximum length of text in the control to eight.
    textBox1.MaxLength = 8
    ' Assign the asterisk to be the password character.
    textBox1.PasswordChar = "*"c
    ' Change all text entered to be lowercase.
    textBox1.CharacterCasing = CharacterCasing.Lower
    ' Align the text in the center of the TextBox control.
    textBox1.TextAlign = HorizontalAlignment.Center
End Sub


[C#] 
public void CreateMyPasswordTextBox()
 {
    // Create an instance of the TextBox control.
    TextBox textBox1 = new TextBox();
    // Set the maximum length of text in the control to eight.
    textBox1.MaxLength = 8;
    // Assign the asterisk to be the password character.
    textBox1.PasswordChar = '*';
    // Change all text entered to be lowercase.
    textBox1.CharacterCasing = CharacterCasing.Lower;
    // Align the text in the center of the TextBox control.
    textBox1.TextAlign = HorizontalAlignment.Center;
 }
 

[C++] 
public:
void CreateMyPasswordTextBox()
 {
    // Create an instance of the TextBox control.
    TextBox* textBox1 = new TextBox();
    // Set the maximum length of text in the control to eight.
    textBox1->MaxLength = 8;
    // Assign the asterisk to be the password character.
    textBox1->PasswordChar = '*';
    // Change all text entered to be lowercase.
    textBox1->CharacterCasing = CharacterCasing::Lower;
    // Align the text in the center of the TextBox control.
    textBox1->TextAlign = HorizontalAlignment::Center;
 }
 

[JScript] 
public function CreateMyPasswordTextBox()
 {
    // Create an instance of the TextBox control.
    textBox1 = new TextBox();
    // Set the maximum length of text in the control to eight.
    textBox1.MaxLength = 8;
    // Assign the asterisk to be the password character.
    textBox1.PasswordChar = '*';
    // Change all text entered to be lowercase.
    textBox1.CharacterCasing = CharacterCasing.Lower;
    // Align the text in the center of the TextBox control.
    textBox1.TextAlign = HorizontalAlignment.Center;
 }
 

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

TextBox クラス | TextBox メンバ | System.Windows.Forms 名前空間 | CharacterCasing