DynamicControl.UIHint Proprietà

Riferimento

Definizione

Spazio dei nomi:: System.Web.DynamicData

Assembly:: System.Web.DynamicData.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Ottiene o imposta il nome del modello di campo usato per eseguire il rendering del campo dati.

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

Valore della proprietà

String

Nome del modello di campo usato per eseguire il rendering del campo dati. Il valore predefinito è una stringa vuota ("") che indica che verrà eseguito il rendering del modello di campo in base al tipo di campo dati o alle informazioni sui metadati applicate al modello dati.

Esempio

Vedere un esempio di codice di runtime di questa funzionalità: Esecuzione.

Nell'esempio seguente viene illustrato come specificare un campo dati per usare un modello di campo diverso per il rendering del relativo contenuto. Il secondo esempio mostra il modello di campo personalizzato specificato dalla UIHint proprietà .

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

Commenti

Usare la UIHint proprietà per specificare il modello di campo da usare per visualizzare l'interfaccia utente per un campo dati. I modelli di campo per impostazione predefinita sono controlli utente e i relativi nomi contengono un suffisso per identificare i modelli di campo usati per le operazioni di modifica e le operazioni di inserimento. I suffissi sono rispettivamente _edit e _insert. Quando si imposta un valore sulla UIHint proprietà , si imposta il nome senza i suffissi. Dynamic Data identificherà la modalità corretta valutando il valore della Mode proprietà e eseguirà il rendering del modello di campo corretto.

Se la UIHint proprietà non è impostata, per impostazione predefinita Dynamic Data eseguirà il rendering del modello di campo in base al tipo di campo. Per altre informazioni, vedere ASP.NET scaffolding dei dati dinamici.

Il modello di campo specificato utilizzando la UIHint proprietà è specifico di questa istanza del DynamicControl controllo. È anche possibile modificare il modello di campo usato da un campo dati nell'intera applicazione applicando al UIHintAttribute modello di dati. L'impostazione della proprietà esegue l'override UIHint dei metadati applicati al modello di dati. Per altre informazioni sugli attributi dei metadati, vedere ASP.NET Dynamic Data.

Si applica a