共用方式為

LoginName.FormatString 屬性

  • 參考

定義

命名空間:
System.Web.UI.WebControls
組件:
System.Web.dll

提供要顯示的格式項目字串。

public:
 virtual property System::String ^ FormatString { System::String ^ get(); void set(System::String ^ value); };
public virtual string FormatString { get; set; }
member this.FormatString : string with get, set
Public Overridable Property FormatString As String

屬性值

String

字串，包含顯示使用者名稱的格式項目。 預設值為 "{0}"。

例外狀況

FormatException

格式字串無效。

範例

下列程式碼範例示範如何在頁面上使用 FormatString 屬性。 按一下按鈕會變更顯示格式。

<%@ 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">

    void Button1_Click(Object sender, EventArgs e) {
        LoginName1.FormatString = "Welcome to our Web site, {0}";
         Button1.Visible = false;
    }

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
        <p>
            <asp:LoginName id="LoginName1" runat="server" 
               FormatString ="Welcome, {0}" />
        </p>
        <p>
            <asp:Button id="Button1" onclick="Button1_Click" runat="server" 
               Text="Change Format" />
        </p>
    </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">

    Sub Button1_Click(sender As Object, e As EventArgs) 
        LoginName1.FormatString = "Welcome to our Web site, {0}"
         Button1.Visible = false
    End Sub

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
        <p>
            <asp:LoginName id="LoginName1" runat="server" 
               FormatString="Welcome, {0}" />
        </p>
        <p>
            <asp:Button id="Button1" onclick="Button1_Click" runat="server" 
               Text="Change Format" />
        </p>
    </form>
</body>
</html>

備註

屬性 FormatString 包含標準文字格式字串，可在網頁上顯示使用者的名稱。 字串 「 {0} 」 表示插入使用者名稱之字串中的何處。 下表描述可用的屬性設定。

屬性設定 行為
預設 (「 {0} 」) 使用者登入時，會顯示使用者的名稱;否則，不會顯示任何專案。
Empty 與預設值相同。 若要隱藏控制項，請將 Visible 屬性設定為 false 。
「歡迎使用我的網站。 {0} 」 顯示「歡迎使用我的網站， 使用者名稱」字串。 當使用者登入時。 未登入使用者時，不會顯示任何內容。
「歡迎使用我的網站」。 當 屬性 FormatString 設定為字串時，會在使用者登入時顯示字串。 因為字串不包含 「 {0} 」，所以不會顯示使用者的名稱。 未登入使用者時，不會顯示任何內容。

當設定時，此屬性的值可以使用設計工具自動儲存到資源檔。 如需詳細資訊，請參閱 LocalizableAttribute 和全球化和當地語系化。

適用於

另請參閱