PasswordBox.PasswordRevealMode 屬性

定義

命名空間:

Microsoft.UI.Xaml.Controls

取得或設定值，這個值會指定密碼一律為永遠、永不或選擇性地遮蔽。

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

PasswordRevealMode PasswordRevealMode();

void PasswordRevealMode(PasswordRevealMode value);

public PasswordRevealMode PasswordRevealMode { get; set; }

var passwordRevealMode = passwordBox.passwordRevealMode;
passwordBox.passwordRevealMode = passwordRevealMode;

Public Property PasswordRevealMode As PasswordRevealMode

屬性值

PasswordRevealMode

列舉值，指定密碼一律為永遠、永不或選擇性遮蔽。 預設值為 預覽。

範例

此範例示範如何使用 CheckBox 讓使用者切換 PasswordBox 的顯示模式。

<StackPanel Width="200">
    <PasswordBox Name="passwordBox1" 
                 PasswordRevealMode="Hidden"/>
    <CheckBox Name="revealModeCheckBox" Content="Show password"
              IsChecked="False" 
              Checked="CheckBox_Changed" Unchecked="CheckBox_Changed"/>
</StackPanel>

private void CheckBox_Changed(object sender, RoutedEventArgs e)
{
    if (revealModeCheckBox.IsChecked == true)
    {
        passwordBox1.PasswordRevealMode = PasswordRevealMode.Visible;
    }
    else
    {
        passwordBox1.PasswordRevealMode = PasswordRevealMode.Hidden;
    }
}

備註

若要變更用來遮蔽密碼的字元，請設定 PasswordChar 屬性。

注意

PasswordRevealMode 取代 IsPasswordRevealButtonEnabled ，讓您有更多選項讓您能夠檢視其密碼。 IsPasswordRevealButtonEnabled 屬性會被忽略。

預覽模式

預設會顯示密碼顯示按鈕 (或「預覽」按鈕)。 使用者必須持續按住該按鈕才能檢視密碼，如此便能維持高等級的安全性。

此屬性的值不是決定使用者是否可以看到密碼顯示按鈕的唯一因素。 其他因素包括控件是否以最小寬度顯示、 PasswordBox 是否具有焦點，以及文字輸入字段是否至少包含一個字元。 基於安全性理由，只有在 PasswordBox 第一次收到焦點且輸入字元時，才會顯示密碼顯示按鈕。 如果 PasswordBox 失去焦點，然後重新取得焦點，除非清除密碼並重新開始輸入字元，否則不會再次顯示顯示按鈕。

隱藏和顯示模式

其他 PasswordRevealMode 列舉值和 HiddenVisible會隱藏密碼顯示按鈕，並讓您以程式設計方式管理密碼是否遮蔽。

若要一律遮蔽密碼，請將 設定 PasswordRevealMode 為 Hidden。 除非您需要一律遮蔽密碼，否則您可以提供自訂 UI，讓使用者在 和 Visible之間Hidden切換 PasswordRevealMode 。 請參閱範例一節，以瞭解如何使用 CheckBox 來切換密碼是否遮蔽。 您也可以使用其他控制項 (例如 ToggleButton)，讓使用者能夠切換模式。

另請參閱

• PasswordRevealMode