LoginName.FormatString Eigenschaft

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 Formatelementen zum Anzeigen des Benutzernamens. Der Standardwert ist "{0}".

Ausnahmen

FormatException

Die Formatzeichenfolge ist ungültig.

Beispiele

Das folgende Codebeispiel zeigt, 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.

Eigenschaftseinstellung Behavior
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 false.
"Willkommen auf meiner Website, {0}." Zeigt die Zeichenfolge "Willkommen bei 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 nicht "{0}" enthält, wird der Name des Benutzers nicht angezeigt. Wenn der Benutzer nicht angemeldet ist, wird nichts angezeigt.

Der Wert dieser Eigenschaft kann automatisch mithilfe eines Designertools in einer Ressourcendatei gespeichert werden. Weitere Informationen finden Sie unter LocalizableAttribute"Globalisierung und Lokalisierung".

Gilt für:

Weitere Informationen