Partager via

LoginName.FormatString Propriété

  • Référence

Définition

Espace de noms:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Fournit une chaîne d'élément de format à afficher.

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

Valeur de propriété

String

Chaîne contenant des éléments de format pour afficher le nom de l'utilisateur. La valeur par défaut est « {0} ».

Exceptions

FormatException

La chaîne de mise en forme n'est pas valide.

Exemples

L’exemple de code suivant montre comment utiliser la FormatString propriété sur une page. Cliquer sur le bouton modifie le format d’affichage.

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

Remarques

La FormatString propriété contient une chaîne de format texte standard qui affiche le nom de l’utilisateur sur la page Web. La chaîne «{0} » indique où le nom de l’utilisateur est inséré dans la chaîne. Le tableau suivant décrit les paramètres de propriété disponibles.

Paramètre de propriété Comportement
Valeur par défaut (« {0} ») Le nom de l’utilisateur s’affiche lorsque l’utilisateur est connecté ; sinon, rien n’est affiché.
Empty Identique à la valeur par défaut. Pour masquer le contrôle, définissez la propriété sur Visiblefalse.
« Bienvenue sur mon site, {0}. » Affiche la chaîne « Bienvenue sur mon site, nom d’utilisateur ». lorsque l’utilisateur est connecté. Lorsque l’utilisateur n’est pas connecté, rien n’est affiché.
« Bienvenue sur mon site. » Lorsque la FormatString propriété est définie sur une chaîne, la chaîne s’affiche lorsque l’utilisateur est connecté. Étant donné que la chaîne ne contient pas «{0} », le nom de l’utilisateur n’est pas affiché. Lorsque l’utilisateur n’est pas connecté, rien n’est affiché.

La valeur de cette propriété, lorsqu’elle est définie, peut être enregistrée automatiquement dans un fichier de ressources à l’aide d’un outil de concepteur. Pour plus d’informations, consultez LocalizableAttributeglobalisation et localisation.

S’applique à

Voir aussi