TemplateInstance Enumeration

Definition

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

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

Felder

Multiple 0

Eine mehrmals instanziierte Vorlage.

Single 1

Eine nur einmal instanziierte Vorlage.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die TemplateInstance Enumeration und die TemplateInstanceAttribute -Klasse verwendet werden. Ein benutzerdefiniertes Steuerelement namens MyLoginViewüberschreibt die AnonymousTemplate -Eigenschaft und verwendet die TemplateInstanceAttribute -Klasse, um anzugeben, dass nur eine instance der AnonymousTemplate Eigenschaft erstellt LoginView 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 in 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 Enumeration gibt Werte an, die angeben, wie oft ein instance einer Vorlage erstellt werden kann. Die TemplateInstanceAttribute -Klasse verwendet Werte aus der TemplateInstanceAttribute Enumeration. Insbesondere geben die Single Felder und Multiple jeweils eine und mehrere Instanzen einer Vorlage an. Mit einer einzelnen instance einer Vorlage können Sie auf Steuerelemente verweisen, die in der Vorlage enthalten sind.

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

Gilt für:

Weitere Informationen