PasswordBox.PasswordRevealMode 屬性

定義

命名空間:

Windows.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;
    }
}

Private Sub CheckBox_Changed(sender As Object, e As RoutedEventArgs)
    If revealModeCheckBox.IsChecked = True Then
        passwordBox1.PasswordRevealMode = PasswordRevealMode.Visible
    Else
        passwordBox1.PasswordRevealMode = PasswordRevealMode.Hidden
    End If
End Sub

備註

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

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

預覽模式

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

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

注意

在Windows 10之前，預設不會顯示密碼顯示按鈕。 如果您的應用程式安全性要求一律隱藏密碼，請務必將 PasswordRevealMode 設定為 Hidden。

隱藏和顯示模式

其他的 PasswordRevealMode 列舉值 (Hidden 和 Visible) 會隱藏密碼顯示按鈕，並讓您能夠以程式設計的方式來管理是否要隱藏密碼。

若要一律遮蔽密碼，請將 PasswordRevealMode 設定為 Hidden。 除非您需要一律遮蔽密碼，否則您可以提供自訂 UI，讓使用者在 Hidden 和 Visible之間切換 PasswordRevealMode。

在舊版的 Windows Phone 中，PasswordBox使用CheckBox來切換密碼是否已遮蔽。 您可以為應用程式建立類似的 UI，如範例所示。 您也可以使用其他控制項 (例如 ToggleButton)，讓使用者能夠切換模式。

另請參閱

• PasswordRevealMode