LoginName.FormatString Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.WebControls
Ensamblado:
System.Web.dll

Proporciona una cadena de elementos de formato para presentación en pantalla.

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

Valor de propiedad

String

Una cadena que contiene los elementos de formato para mostrar el nombre del usuario. El valor predeterminado es "{0}".

Excepciones

FormatException

La cadena de formato no es válida.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar la FormatString propiedad en una página. Al hacer clic en el botón se cambia el formato de presentación.

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

Comentarios

La FormatString propiedad contiene una cadena de formato de texto estándar que muestra el nombre del usuario en la página web. La cadena "{0}" indica dónde se inserta el nombre del usuario en la cadena. En la tabla siguiente se describen los valores de propiedad disponibles.

Valor de propiedad Comportamiento
Valor predeterminado ("{0}") El nombre del usuario se muestra cuando el usuario ha iniciado sesión; de lo contrario, no se muestra nada.
Empty Igual que el predeterminado. Para ocultar el control, establezca la Visible propiedad falseen .
"Bienvenido a mi sitio, {0}." Muestra la cadena "Welcome to my site, username" (Bienvenido a mi sitio, nombre de usuario) cuando el usuario ha iniciado sesión. Cuando el usuario no ha iniciado sesión, no se muestra nada.
"Bienvenido a mi sitio." Cuando la FormatString propiedad se establece en una cadena, la cadena se muestra cuando el usuario ha iniciado sesión. Dado que la cadena no contiene "{0}", no se muestra el nombre del usuario. Cuando el usuario no ha iniciado sesión, no se muestra nada.

El valor de esta propiedad, cuando se establece, se puede guardar automáticamente en un archivo de recursos mediante una herramienta de diseñador. Para obtener más información, vea LocalizableAttributeGlobalización y localización.

Se aplica a

Consulte también