DynamicControl.UIHint プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 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, setPublic Overridable Property UIHint As 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」を参照してください。
