LoginName.FormatString Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls
Zestaw:
System.Web.dll

Udostępnia ciąg elementu formatu do wyświetlenia.

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

Wartość właściwości

String

Ciąg zawierający elementy formatu służące do wyświetlania nazwy użytkownika. Wartość domyślna to "{0}".

Wyjątki

FormatException

Ciąg formatu jest nieprawidłowy.

Przykłady

Poniższy przykład kodu pokazuje, jak używać FormatString właściwości na stronie. Kliknięcie przycisku zmienia format wyświetlania.

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

Uwagi

Właściwość FormatString zawiera standardowy ciąg formatu tekstu, który wyświetla nazwę użytkownika na stronie sieci Web. Ciąg "{0}" wskazuje, gdzie w ciągu wstawiono nazwę użytkownika. W poniższej tabeli opisano dostępne ustawienia właściwości.

Ustawienie właściwości Zachowanie
Wartość domyślna ("{0}") Nazwa użytkownika jest wyświetlana, gdy użytkownik jest zalogowany; w przeciwnym razie nic nie jest wyświetlane.
Empty Tak samo jak wartość domyślna. Aby ukryć kontrolkę Visible , ustaw właściwość na false.
"Witamy w mojej witrynie, {0}." Wyświetla ciąg "Witamy w mojej witrynie, nazwa użytkownika". gdy użytkownik jest zalogowany. Gdy użytkownik nie jest zalogowany, nic nie jest wyświetlane.
"Witamy w mojej witrynie"." FormatString Gdy właściwość jest ustawiona na ciąg, ciąg jest wyświetlany po zalogowaniu użytkownika. Ponieważ ciąg nie zawiera ciągu "{0}", nazwa użytkownika nie jest wyświetlana. Gdy użytkownik nie jest zalogowany, nic nie jest wyświetlane.

Wartość tej właściwości, po ustawieniu, można automatycznie zapisać w pliku zasobów za pomocą narzędzia projektanta. Aby uzyskać więcej informacji, zobacz LocalizableAttribute Globalization and Localization (Globalizacja i lokalizacja).

Dotyczy

Zobacz też