Freigeben über

TemplateInstance Enumeration

Definition

Namespace:
System.Web.UI
Assembly:
System.Web.dll

Gibt an, wie oft eine Instanz einer Vorlage erstellt werden kann.

public enum class TemplateInstance
public enum TemplateInstance
type TemplateInstance = 
Public Enum TemplateInstance
Vererbung
Object
ValueType
Enum
TemplateInstance

Felder

Name Wert Beschreibung
Multiple 0

Eine Vorlage, die mehrmals instanziiert wird.
Single 1

Eine Vorlage, die nur einmal instanziiert wird.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der TemplateInstance Enumeration und der TemplateInstanceAttribute Klasse veranschaulicht. Ein benutzerdefiniertes LoginView Steuerelement mit dem Namen MyLoginViewüberschreibt die AnonymousTemplate Eigenschaft und verwendet die TemplateInstanceAttribute Klasse, um anzugeben, dass nur eine Instanz der AnonymousTemplate Eigenschaft erstellt wird.

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;
            }
        }
    }
}

Imports System.Data
Imports System.ComponentModel
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls

Namespace Samples.AspNet.VB.Controls

    Public Class MyLoginView
        Inherits LoginView

        Private _anonymoustemplate As ITemplate

        <Browsable(False), DefaultValue(""), PersistenceMode(PersistenceMode.InnerProperty), TemplateContainer(GetType(LoginView)), TemplateInstance(TemplateInstance.Single)> _
        Public Overrides Property AnonymousTemplate() As System.Web.UI.ITemplate
            Get
                Return _anonymoustemplate
            End Get
            Set(ByVal value As System.Web.UI.ITemplate)
                _anonymoustemplate = value
            End Set
        End Property

    End Class

End Namespace

Das folgende Codebeispiel ist eine ASPX-Datei, die das MyLoginView Steuerelement verwendet und veranschaulicht, wie auf ein Label Steuerelement zugegriffen wird, das sich innerhalb der AnonymousTemplate Eigenschaft befindet.

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

<%@ Page Language="VB" %>
<%@ Register TagPrefix="AspNetSamples" Namespace="Samples.AspNet.VB.Controls" Assembly="Samples.AspNet.VB.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 Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
    
    Me.DataBind()
    Me.LoginViewLabel1.Text = "LoginView Anonymous Template Label Set Dynamically."

  End Sub
  
</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>

Hinweise

Die TemplateInstance Aufzählung gibt Werte an, die angeben, wie oft eine Instanz einer Vorlage erstellt werden kann. Die TemplateInstanceAttribute Klasse verwendet Werte aus der TemplateInstanceAttribute Enumeration. Insbesondere geben die Single Felder Multiple einzelne und mehrere Instanzen einer Vorlage bzw. mehrere Instanzen einer Vorlage an. Mit einer einzelnen Instanz einer Vorlage können Sie auf Steuerelemente verweisen, die in der Vorlage enthalten sind.

Beispiele für Steuerelemente, die den einzelnen Wert in Eigenschaftsmetadaten verwenden, sind die ZoneTemplate Eigenschaft des CatalogZone Steuerelements, die ZoneTemplate Eigenschaft des EditorZone Steuerelements und die ZoneTemplate Eigenschaft der .WebPartZone

Gilt für:

Weitere Informationen