DynamicControl.UIHint プロパティ

リファレンス

定義

名前空間:: System.Web.DynamicData

アセンブリ:: System.Web.DynamicData.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

データフィールドの表示に使用するフィールドテンプレートの名前を取得または設定します。

public:
 virtual property System::String ^ UIHint { System::String ^ get(); void set(System::String ^ value); };

public virtual string UIHint { get; set; }

member this.UIHint : string with get, set

Public Overridable Property UIHint As String

プロパティ値

String

データフィールドの表示に使用するフィールドテンプレートの名前。既定値は空の文字列 ("") です。これは、データフィールドの型、またはデータモデルに適用されるメタデータ情報に基づいて、フィールドテンプレートが表示されることを示します。

例

この機能の実行時コード例を参照してください: 実行。

次の例では、データフィールドを指定して、別のフィールドテンプレートを使用してその内容をレンダリングする方法を示します。 2 番目の例は、プロパティで指定されたユーザー設定フィールドテンプレートを UIHint 示しています。

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
  protected void Page_Init(object sender, EventArgs e)
  {
    DynamicDataManager1.RegisterControl(Repeater1);
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
  <title>DynamicControl.UIHint Sample</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:DynamicDataManager ID="DynamicDataManager1" runat="server"
        AutoLoadForeignKeys="true" />
        
      <asp:Repeater ID="Repeater1" runat="server" DataSourceID="LinqDataSource1">
        <HeaderTemplate>
          <table border="1">
            <tr>
               <th>First Name</th>
               <th>Last Name</th>
               <th>Email</th>
            </tr>        
        </HeaderTemplate>
        <ItemTemplate>
          <tr>
            <td><asp:DynamicControl runat="server" DataField="FirstName" /></td>
            <td><asp:DynamicControl runat="server" DataField="LastName" /></td>
            <td><asp:DynamicControl runat="server" DataField="EmailAddress" UIHint="Email" /> </td>
          </tr>
        </ItemTemplate>
        <FooterTemplate>
          </table>
        </FooterTemplate>
      </asp:Repeater>

      <asp:LinqDataSource ID="LinqDataSource1" runat="server" 
        TableName="Customers"
        ContextTypeName="AdventureWorksLTDataContext">
      </asp:LinqDataSource>
    </div>
    </form>
</body>
</html>

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  Protected Sub Page_Init(ByVal sender As Object, ByVal e As System.EventArgs)    
    DynamicDataManager1.RegisterControl(Repeater1)
  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
  <title>DynamicControl.UIHint Sample</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:DynamicDataManager ID="DynamicDataManager1" runat="server"
        AutoLoadForeignKeys="true" />
        
      <asp:Repeater ID="Repeater1" runat="server" DataSourceID="LinqDataSource1">
        <HeaderTemplate>
          <table border="1">
            <tr>
               <th>First Name</th>
               <th>Last Name</th>
               <th>Email</th>
            </tr>        
        </HeaderTemplate>
        <ItemTemplate>
          <tr>
            <td><asp:DynamicControl runat="server" DataField="FirstName" /></td>
            <td><asp:DynamicControl runat="server" DataField="LastName" /></td>
            <td><asp:DynamicControl runat="server" DataField="EmailAddress" UIHint="Email" /> </td>
          </tr>
        </ItemTemplate>
        <FooterTemplate>
          </table>
        </FooterTemplate>
      </asp:Repeater>

      <asp:LinqDataSource ID="LinqDataSource1" runat="server" 
        TableName="Customers"
        ContextTypeName="AdventureWorksLTDataContext">
      </asp:LinqDataSource>
    </div>
    </form>
</body>
</html>

<%@ Control Language="C#" ClassName="Email" Inherits="System.Web.DynamicData.FieldTemplateUserControl"%>

<script runat="server">
  protected string GetNavigateUrl()
  {
    if (!String.IsNullOrEmpty(FieldValueString))
    {
      return "mailto:" + FieldValueString;
    }

    return string.Empty;
  }
</script>

<asp:HyperLink ID="EmailAddressLink" runat="server"
    Text="<%# FieldValueString %>"
    NavigateUrl="<%# GetNavigateUrl() %>"  />

<%@ Control Language="VB" ClassName="Email" Inherits="System.Web.DynamicData.FieldTemplateUserControl"%>

<script runat="server">
    
    Protected Function GetNavigateUrl() As String

        If (Not String.IsNullOrEmpty(FieldValueString)) Then
            Return "mailto:" & FieldValueString
        End If
    
        Return String.Empty

    End Function
    
</script>

<asp:HyperLink ID="EmailAddressLink" runat="server"
    Text="<%# FieldValueString %>"
    NavigateUrl="<%# GetNavigateUrl() %>"  />

注釈

このプロパティを UIHint 使用して、データフィールドの UI の表示に使用するフィールドテンプレートを指定します。既定では、フィールドテンプレートはユーザーコントロールであり、その名前には、編集操作と挿入操作に使用されるフィールドテンプレートを識別するためのサフィックスが含まれています。サフィックスはそれぞれ_editされ、_insertされます。プロパティに値を UIHint 設定するときは、サフィックスを付けずに名前を設定します。動的データは、プロパティ値を評価することによって正しいモードを Mode 識別し、正しいフィールドテンプレートをレンダリングします。

プロパティが UIHint 設定されていない場合、既定では、動的データはフィールドの種類に基づいてフィールドテンプレートをレンダリングします。詳細については、「動的データスキャフォールディング ASP.NET」を参照してください。

プロパティを使用して UIHint 指定するフィールドテンプレートは、コントロールの DynamicControl このインスタンスに固有です。データモデルに適用 UIHintAttribute することで、アプリケーション全体でデータフィールドで使用されるフィールドテンプレートを変更することもできます。プロパティを設定すると UIHint 、データモデルに適用されるメタデータがオーバーライドされます。メタデータ属性の詳細については、「動的データの ASP.NET」を参照してください。

適用対象

DynamicControl.UIHint プロパティ

定義

プロパティ値

例

注釈

適用対象

こちらもご覧ください

その他のリソース