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, set
Public 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範本,則可以使用 Literal 控件來指出範本上要顯示FailureText屬性的位置,並提供該控件標識碼 「FailureText」。。 當您使用範本時, FailureTextStyle 屬性不會套用至 屬性中指定的 FailureText 文字。
屬性的預設文字會根據伺服器的目前地區設定進行當地語系化。
注意
基於安全性考慮,登入失敗文字不應包含失敗的特定原因。 例如,「使用者名稱密碼無效<>」之類的錯誤訊息會向潛在攻擊者<顯示使用者名稱>是系統上的使用者。 如需詳細資訊,請參閱 如何:顯示安全錯誤訊息。
當設定時,此屬性的值可以使用設計工具自動儲存到資源檔。 如需詳細資訊,請參閱 LocalizableAttribute和全球化和當地語系化。