DynamicControl.UIHint Eigenschap

Definitie

Naamruimte:
System.Web.DynamicData
Assembly:
System.Web.DynamicData.dll

Hiermee haalt u de naam op van de veldsjabloon die wordt gebruikt om het gegevensveld weer te geven.

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

Waarde van eigenschap

String

De naam van de veldsjabloon die wordt gebruikt om het gegevensveld weer te geven. De standaardwaarde is een lege tekenreeks (""), die aangeeft dat de veldsjabloon wordt weergegeven op basis van het gegevensveldtype of op metagegevensgegevens die zijn toegepast op het gegevensmodel.

Voorbeelden

In het volgende voorbeeld ziet u hoe u een gegevensveld kunt opgeven om een andere veldsjabloon te gebruiken om de inhoud ervan weer te geven. In het tweede voorbeeld ziet u de aangepaste veldsjabloon die is opgegeven door de UIHint eigenschap.

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

Opmerkingen

Gebruik de UIHint eigenschap om de veldsjabloon op te geven die moet worden gebruikt om de gebruikersinterface voor een gegevensveld weer te geven. Veldsjablonen zijn standaard besturingselementen van gebruikers en hun namen bevatten een achtervoegsel om veldsjablonen te identificeren die worden gebruikt voor bewerkingen en invoegbewerkingen. De achtervoegsels worden respectievelijk _edit en _insert. Wanneer u een waarde instelt op de UIHint eigenschap, stelt u de naam zonder de achtervoegsels in. Dynamische gegevens identificeren de juiste modus door de Mode eigenschapswaarde te evalueren en de juiste veldsjabloon weer te geven.

Als de UIHint eigenschap niet is ingesteld, wordt de veldsjabloon standaard weergegeven op basis van het veldtype. Zie ASP.NET Dynamic Data Scaffolding voor meer informatie.

De veldsjabloon die u opgeeft met behulp van de UIHint eigenschap is specifiek voor dit exemplaar van het DynamicControl besturingselement. U kunt ook de veldsjabloon wijzigen die wordt gebruikt door een gegevensveld in de hele toepassing door het UIHintAttribute toe te passen op uw gegevensmodel. Als u de UIHint eigenschap instelt, worden de metagegevens overschreven die zijn toegepast op het gegevensmodel. Zie ASP.NET Dynamic Data voor meer informatie over metagegevenskenmerken.

Van toepassing op

Zie ook