LoginName.FormatString Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Stellt eine anzuzeigende Formatelementzeichenfolge bereit.

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

Eigenschaftswert

String

Eine Zeichenfolge mit den Formatelementen zum Anzeigen des Namens des Benutzers. Der Standardwert ist „{0}“.

Ausnahmen

FormatException

Die Formatzeichenfolge ist nicht gültig.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die FormatString -Eigenschaft auf einer Seite verwendet wird. Durch Klicken auf die Schaltfläche wird das Anzeigeformat geändert.

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

Hinweise

Die FormatString Eigenschaft enthält eine Standardtextformatzeichenfolge, die den Namen des Benutzers auf der Webseite anzeigt. Die Zeichenfolge "{0}" gibt an, wo in der Zeichenfolge der Name des Benutzers eingefügt wird. In der folgenden Tabelle werden die verfügbaren Eigenschafteneinstellungen beschrieben.

Eigenschafteneinstellung Verhalten
Standard ("{0}") Der Name des Benutzers wird angezeigt, wenn der Benutzer angemeldet ist. andernfalls wird nichts angezeigt.
Empty Wie Standard. Um das Steuerelement auszublenden, legen Sie die Visible -Eigenschaft auf falsefest.
"Willkommen auf meiner Website, {0}." Zeigt die Zeichenfolge "Willkommen auf meiner Website, Benutzername" an, wenn der Benutzer angemeldet ist. Wenn der Benutzer nicht angemeldet ist, wird nichts angezeigt.
"Willkommen auf meiner Website." Wenn die FormatString Eigenschaft auf eine Zeichenfolge festgelegt ist, wird die Zeichenfolge angezeigt, wenn der Benutzer angemeldet ist. Da die Zeichenfolge kein "{0}" enthält, wird der Name des Benutzers nicht angezeigt. Wenn der Benutzer nicht angemeldet ist, wird nichts angezeigt.

Der Wert dieser Eigenschaft, wenn festgelegt, kann mithilfe eines Designers Tools automatisch zu einer Ressourcendatei gespeichert werden. Weitere Informationen finden Sie unter LocalizableAttribute und Globalisierung und Lokalisierung.

Gilt für:

Weitere Informationen