DynamicControl.UIHint Vlastnost

Reference

Definice

Obor názvů:: System.Web.DynamicData

Sestavení:: System.Web.DynamicData.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá nebo nastaví název šablony pole, která se používá k vykreslení datového pole.

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

Hodnota vlastnosti

String

Název šablony pole, která se používá k vykreslení datového pole. Výchozí hodnota je prázdný řetězec (""), který označuje, že šablona pole se vykreslí na základě datového typu pole nebo informací o metadatech použitých v datovém modelu.

Příklady

Podívejte se na příklad kódu za běhu této funkce: Spustit.

Následující příklad ukazuje, jak můžete zadat datové pole pro použití jiné šablony pole k vykreslení jeho obsahu. Druhý příklad ukazuje šablonu vlastního pole určenou vlastností 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() %>"  />

Poznámky

UIHint Pomocí vlastnosti určete šablonu pole, která se má použít k zobrazení uživatelského rozhraní pro datové pole. Šablony polí jsou ve výchozím nastavení uživatelské ovládací prvky a jejich názvy obsahují příponu pro identifikaci šablon polí, které se používají pro operace úprav a operace vložení. Přípony jsou _edit a _insert. Když nastavíte hodnotu na UIHint vlastnost, nastavíte název bez přípon. Dynamická data identifikují správný režim vyhodnocením Mode hodnoty vlastnosti a vykreslí správnou šablonu pole.

UIHint Pokud vlastnost není nastavená, dynamická data ve výchozím nastavení vykreslí šablonu pole na základě typu pole. Další informace najdete v tématu ASP.NET generování dynamických dat.

Šablona pole, kterou zadáte pomocí UIHint vlastnosti, je specifická pro tuto instanci DynamicControl ovládacího prvku. Šablonu pole používanou datovým polem v celé aplikaci můžete také změnit použitím datového UIHintAttribute modelu. UIHint Nastavení vlastnosti přepíše metadata použitá pro datový model. Další informace o atributech metadat najdete v tématu ASP.NET Dynamická data.

Platí pro

Sdílet prostřednictvím