LoginName.FormatString Vlastnost

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Poskytuje řetězec položky formátu, který se má zobrazit.

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

Hodnota vlastnosti

String

Řetězec obsahující položky formátu pro zobrazení jména uživatele. Výchozí hodnota je "{0}".

Výjimky

FormatException

Formátovací řetězec není platný.

Příklady

Následující příklad kódu ukazuje, jak použít FormatString vlastnost na stránce. Kliknutím na tlačítko změníte formát zobrazení.

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

Poznámky

Vlastnost FormatString obsahuje standardní řetězec textového formátu, který zobrazuje jméno uživatele na webové stránce. Řetězec "{0}" označuje, kam se v řetězci vloží jméno uživatele. Následující tabulka popisuje dostupná nastavení vlastností.

Nastavení vlastnosti Chování
Výchozí ("{0}") Jméno uživatele se zobrazí při přihlášení uživatele; jinak se nic nezobrazí.
Empty Stejné jako výchozí. Chcete-li ovládací prvek skrýt, nastavte Visible vlastnost na false.
"Vítejte na mém webu, {0}." Zobrazí řetězec "Vítejte na mém webu, uživatelské jméno". když je uživatel přihlášený. Pokud uživatel není přihlášený, nezobrazí se nic.
"Vítejte na mém webu." FormatString Pokud je vlastnost nastavena na řetězec, řetězec se zobrazí při přihlášení uživatele. Protože řetězec neobsahuje "{0}", uživatelské jméno se nezobrazí. Pokud uživatel není přihlášený, nezobrazí se nic.

Hodnotu této vlastnosti lze při nastavení automaticky uložit do souboru prostředků pomocí nástroje návrháře. Další informace najdete v tématech LocalizableAttribute o globalizaci a lokalizaci.

Platí pro

Viz také