Cette documentation est archivée et n’est pas conservée.

TemplateInstance, énumération

Mise à jour : novembre 2007

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

Espace de noms :  System.Web.UI
Assembly :  System.Web (dans System.Web.dll)

public enum TemplateInstance
public enum TemplateInstance
public enum TemplateInstance

Nom de membreDescription
MultipleModèle instancié plusieurs fois.
SingleModèle instancié une seule fois.

L'énumération TemplateInstance spécifie des valeurs qui indiquent le nombre de fois qu'une instance d'un modèle peut être créée. La classe TemplateInstanceAttribute utilise des valeurs issues de l'énumération TemplateInstance. En particulier, les champs Single et Multiple spécifient respectivement une ou plusieurs instances d'un modèle. Une instance unique d'un modèle vous permet de référencer des contrôles que contient ce dernier.

Les contrôles qui utilisent la valeur Single dans les métadonnées de propriété sont notamment la propriété ZoneTemplate du contrôle CatalogZone, la propriété ZoneTemplate du contrôle EditorZone et la propriété ZoneTemplate du WebPartZone.

L'exemple de code suivant illustre l'utilisation de l'énumération TemplateInstance et de la classe TemplateInstanceAttribute. Un contrôle LoginView personnalisé nommé MyLoginView substitue la propriété AnonymousTemplate et utilise la classe TemplateInstanceAttribute pour spécifier qu'une seule instance de la propriété AnonymousTemplate 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 consiste en un fichier ASPX qui utilise le contrôle MyLoginView et montre comment accéder à un contrôle Label placé à l'intérieur de la propriété AnonymousTemplate.

<%@ 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>


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0
Afficher: