FormatString, propriété
Réduire la table des matières
Développer la table des matières

LoginName.FormatString, propriété

Remarque : cette propriété est nouvelle dans le .NET Framework version 2.0.

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

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)

[LocalizableAttribute(true)] 
public virtual string FormatString { get; set; }
/** @property */
public String get_FormatString ()

/** @property */
public void set_FormatString (String value)

public function get FormatString () : String

public function set FormatString (value : String)

Valeur de la propriété

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

Type d'exceptionCondition

FormatException

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

La propriété FormatString contient une chaîne de mise en forme de texte standard qui affiche le nom de l'utilisateur sur la page Web. La chaîne "{0}" indique l'emplacement 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 est affiché lorsque l'utilisateur est connecté ; sinon, rien n'est affiché.

Empty

Identique à la valeur par défaut. Pour masquer le contrôle, affectez false à la propriété Visible.

"Bienvenue dans mon site, {0}."

Affiche la chaîne "Bienvenue dans mon site, username." lorsque l'utilisateur se connecte. Lorsque l'utilisateur n'est pas connecté, rien n'est affiché.

"Bienvenue dans mon site."

Lorsqu'une chaîne est affectée à la propriété FormatString, la chaîne est affichée lorsque l'utilisateur se connecte. É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 ne s'affiche.

La valeur de cette propriété, lorsqu'elle est définie, peut être enregistrée automatiquement dans un fichier de ressources en utilisant un outil de conception. Pour plus d'informations, consultez LocalizableAttribute et Globalisation et localisation ASP.NET.

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

<%@ Page Language="C#" autoeventwireup="False" %>
<script runat="server">

    void Button1_Click(Object sender, EventArgs e) {
        LoginName1.FormatString = "Welcome to our Web site, {0}";
         Button1.Visible = false;
    }

</script>
<html>
<head>
</head>
<body>
    <form 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>

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2016 Microsoft