DynamicControl.UIHint Tulajdonság

Definíció

Névtér:
System.Web.DynamicData
Szerelvény:
System.Web.DynamicData.dll

Lekéri vagy beállítja az adatmező megjelenítéséhez használt mezősablon nevét.

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

Tulajdonság értéke

String

Az adatmező megjelenítéséhez használt mezősablon neve. Az alapértelmezett érték egy üres sztring (""), amely azt jelzi, hogy a mezősablon az adatmező típusa vagy az adatmodellre alkalmazott metaadatok alapján jelenik meg.

Példák

Az alábbi példa bemutatja, hogyan adhat meg egy adatmezőt egy másik mezősablon használatával a tartalma megjelenítéséhez. A második példa a tulajdonság által megadott egyéni mezősablont UIHint mutatja be.

<%@ 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() %>"  />

Megjegyzések

UIHint A tulajdonság használatával adja meg az adatmezők felhasználói felületének megjelenítéséhez használandó mezősablont. A mezősablonok alapértelmezés szerint felhasználói vezérlők, és nevük egy utótagot tartalmaz a szerkesztési műveletekhez és műveletek beszúrásához használt mezősablonok azonosításához. Az utótagok _edit és _insert. Amikor értéket ad meg a UIHint tulajdonságnak, utótagok nélkül adja meg a nevet. A dinamikus adatok a tulajdonságérték kiértékelésével azonosítják a Mode megfelelő módot, és a megfelelő mezősablont jelenítik meg.

Ha a UIHint tulajdonság nincs beállítva, a Dinamikus adatok alapértelmezés szerint a mezőtípus alapján jeleníti meg a mezősablont. További információ: ASP.NET Dynamic Data Scaffolding.

A tulajdonság használatával UIHint megadott mezősablon a vezérlőelem ezen példányára DynamicControl vonatkozik. Az adatmezők által használt mezősablont az egész alkalmazáson belül módosíthatja az UIHintAttribute adatmodell alkalmazásával. A UIHint tulajdonság beállítása felülírja az adatmodellre alkalmazott metaadatokat. További információ a metaadat-attribútumokról: ASP.NET Dinamikus adatok.

A következőre érvényes:

Lásd még