Login.FailureText 屬性
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
當登入嘗試失敗時，會取得或設定顯示的文字。
public:
virtual property System::String ^ FailureText { System::String ^ get(); void set(System::String ^ value); };public virtual string FailureText { get; set; }member this.FailureText : string with get, setPublic Overridable Property FailureText As String屬性值
當登入失敗時，使用者會看到文字。 預設是「您的登入嘗試失敗。 請再試一次。
範例
以下程式碼範例將屬性設定 FailureText 為「登入時發生錯誤。 請再試一次。」
<%@ Page Language="C#" AutoEventWireup="False"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:Login id="Login1" runat="server" FailureText="There was an error while logging you in. Please try again.">
<FailureTextStyle ForeColor="White" BackColor="Red"></FailureTextStyle>
</asp:Login>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="False"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:Login id="Login1" runat="server" FailureText="There was an error while logging you in. Please try again.">
<FailureTextStyle ForeColor="White" BackColor="Red"></FailureTextStyle>
</asp:Login>
</form>
</body>
</html>
備註
屬性 FailureText 指定了當登入嘗試失敗時顯示的字串。
如果你為控制項定義了範本Login，你可以用控制項指定屬性在範本中的位置，FailureTextLiteral並將該控制項的 ID 設為「FailureText」。 使用範本時，該 FailureTextStyle 屬性不會套用到該 FailureText 屬性中指定的文字。
該屬性的預設文字會根據伺服器目前所在的位置進行本地化。
備註
出於安全考量，登入失敗文字不應包含具體失敗原因。 例如，錯誤訊息如「密碼不適用於使用者 <名稱>」會讓潛在攻擊者 <知道該使用者> 是系統上的使用者。 欲了解更多資訊，請參閱 「如何：顯示安全錯誤訊息」。
設定後，該屬性的值可透過設計工具自動儲存到資源檔案中。 欲了解更多資訊，請參閱LocalizableAttribute全球化與在地化。
