LoginName.FormatString Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет подлежащую отображению строку элемента формата.
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
Значение свойства
Строка, содержащая элемент формата для отображения имени пользователя. Значение по умолчанию — {0}.
Исключения
Строка формата недопустима.
Примеры
В следующем примере кода показано, как использовать 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и Глобализация и локализация.