Поделиться через

LoginName.FormatString Свойство

  • Ссылка

Определение

Пространство имен:
System.Web.UI.WebControls
Сборка:
System.Web.dll

Предоставляет подлежащую отображению строку элемента формата.

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

Значение свойства

String

Строка, содержащая элемент формата для отображения имени пользователя. Значение по умолчанию — {0}.

Исключения

FormatException

Строка формата недопустима.

Примеры

В следующем примере кода показано, как использовать FormatString свойство на странице. При нажатии кнопки изменяется формат отображения.

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

Комментарии

Свойство FormatString содержит строку стандартного текстового формата, которая отображает имя пользователя на веб-странице. Строка "{0}" указывает, куда вставляется имя пользователя. В следующей таблице описаны доступные параметры свойств.

Задание параметра свойства Поведение
По умолчанию ("{0}") Имя пользователя отображается при входе пользователя в систему; в противном случае ничего не отображается.
Empty То же, что и по умолчанию. Чтобы скрыть элемент управления, присвойте свойству Visible значение false.
"Добро пожаловать на мой сайт, {0}." Отображает строку "Добро пожаловать на мой сайт, имя пользователя". При входе пользователя в систему. Если пользователь не вошел в систему, ничего не отображается.
"Добро пожаловать на мой сайт." Если для FormatString свойства задана строка, она отображается при входе пользователя в систему. Так как строка не содержит "{0}", имя пользователя не отображается. Если пользователь не вошел в систему, ничего не отображается.

Значение этого свойства, если оно задано, можно автоматически сохранить в файл ресурсов с помощью средства конструктора. Дополнительные сведения см. в разделах LocalizableAttributeи Глобализация и локализация.

Применяется к

См. также раздел