Lire en anglais

Partager via


TemplateInstance Énumération

Définition

Spécifie combien de fois une instance d'un modèle peut être créée.

public enum TemplateInstance
Héritage
TemplateInstance

Champs

Nom Valeur Description
Multiple 0

Modèle instancié plusieurs fois.

Single 1

Modèle instancié une seule fois.

Exemples

L’exemple de code suivant montre comment utiliser l’énumération TemplateInstance et la TemplateInstanceAttribute classe . Un contrôle personnaliséLoginView, nommé MyLoginView, remplace la AnonymousTemplate propriété et utilise la TemplateInstanceAttribute classe pour spécifier qu’une seule instance de la AnonymousTemplate propriété est créée.

using System;
using System.Data;
using System.ComponentModel;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;

namespace Samples.AspNet.CS.Controls
{
    public class MyLoginView : LoginView
    {
        private ITemplate _anonymoustemplate;

        [Browsable(false),
        DefaultValue(null),
        PersistenceMode(PersistenceMode.InnerProperty),
        TemplateContainer(typeof(LoginView)),
        TemplateInstance(TemplateInstance.Single)
        ]
        public override ITemplate AnonymousTemplate
        {
            get
            {
                return _anonymoustemplate;
            }
            set
            {
                _anonymoustemplate = value;
            }
        }
    }
}

L’exemple de code suivant est un fichier ASPX qui utilise le MyLoginView contrôle et montre comment accéder à un Label contrôle qui se trouve à l’intérieur de la AnonymousTemplate propriété.

<%@ Page Language="C#" %>
<%@ Register TagPrefix="AspNetSamples" Namespace="Samples.AspNet.CS.Controls" Assembly="Samples.AspNet.CS.Controls" %>
<!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_Load(object sender, EventArgs e)
  {
    this.DataBind();
    this.LoginViewLabel1.Text = "LoginView Anonymous Template Label Set Dynamically.";    
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>TemplateInstance Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <AspNetSamples:MyLoginView id="MyLoginView1" runat="server">
        <AnonymousTemplate>
          <asp:Label ID="LoginViewLabel1" runat="server" Text="Test"/>
        </AnonymousTemplate>
      </AspNetSamples:MyLoginView>
    </div>
    </form>
</body>
</html>

Remarques

L’énumération TemplateInstance spécifie des valeurs indiquant le nombre de fois où une instance d’un modèle peut être créée. La TemplateInstanceAttribute classe utilise des valeurs de l’énumération TemplateInstanceAttribute . En particulier, les Single champs et Multiple spécifient respectivement une seule et plusieurs instances d’un modèle. Une seule instance d’un modèle vous permet de référencer des contrôles contenus dans le modèle.

Parmi les exemples de contrôles qui utilisent la valeur Unique dans les métadonnées de propriété, citons la ZoneTemplateCatalogZone propriété du contrôle, la EditorZoneZoneTemplate propriété du contrôle et la ZoneTemplate propriété de .WebPartZone

S’applique à

Produit Versions
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Voir aussi