Condividi tramite

LoginName.FormatString Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Fornisce una stringa dell'elemento di formato da visualizzare.

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

Valore della proprietà

String

Stringa che contiene gli elementi di formato per la visualizzazione del nome dell'utente. Il valore predefinito è "{0}".

Eccezioni

FormatException

La stringa di formato non è valida.

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare la FormatString proprietà in una pagina. Facendo clic sul pulsante viene modificato il formato di visualizzazione.

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

Commenti

La FormatString proprietà contiene una stringa di formato testo standard che visualizza il nome dell'utente nella pagina Web. La stringa "{0}" indica dove viene inserito il nome dell'utente nella stringa. Nella tabella seguente vengono descritte le impostazioni delle proprietà disponibili.

Impostazione della proprietà Comportamento
Impostazione predefinita ("{0}") Il nome dell'utente viene visualizzato quando l'utente è connesso; in caso contrario, non viene visualizzato alcun elemento.
Empty Uguale all'impostazione predefinita. Per nascondere il controllo, impostare la Visible proprietà su false.
"Benvenuti nel mio sito, {0}." Visualizza la stringa "Welcome to my site, username" quando l'utente ha effettuato l'accesso. Quando l'utente non è connesso, non viene visualizzato alcun elemento.
"Benvenuti nel mio sito." Quando la FormatString proprietà è impostata su una stringa, la stringa viene visualizzata quando l'utente esegue l'accesso. Poiché la stringa non contiene "{0}", il nome dell'utente non viene visualizzato. Quando l'utente non è connesso, non viene visualizzato alcun elemento.

Il valore di questa proprietà, se impostato, può essere salvato automaticamente in un file di risorse usando uno strumento di progettazione. Per altre informazioni, vedere LocalizableAttributeGlobalizzazione e localizzazione.

Si applica a

Vedi anche