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 プロパティには、Web ページにユーザーの名前を表示する標準のテキスト書式指定文字列が含まれています。 文字列 "{0}" は、文字列内のユーザーの名前が挿入される場所を示します。 次の表では、使用可能なプロパティの設定について説明します。

プロパティの設定 動作
既定値 (""{0}) ユーザーの名前は、ユーザーがログオンしたときに表示されます。それ以外の場合は、何も表示されません。
Empty 既定値と同じ。 コントロールを非表示にするには、プロパティを > にfalse設定しますVisible。
"私のサイトへようこそ, {0}." "個人用サイトへようこそ、 ユーザー名" という文字列が表示されます。 ユーザーがログインしているとき。 ユーザーがログインしていない場合、何も表示されません。
"私のサイトへようこそ。 プロパティを FormatString 文字列に設定すると、ユーザーがログインしたときに文字列が表示されます。 文字列に "{0}" が含まれていないため、ユーザーの名前は表示されません。 ユーザーがログインしていない場合、何も表示されません。

このプロパティの値を設定すると、デザイナー ツールを使用してリソース ファイルに自動的に保存できます。 詳細については、「グローバリゼーションとローカライズ」を参照してくださいLocalizableAttribute。

適用対象

こちらもご覧ください