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