TemplateDefinition Класс

Определение

Пространство имен:

System.Web.UI.Design

Сборка:

System.Design.dll

Предоставляют свойства и методы, определяющие элемент шаблона в элементе управления веб-сервера во время разработки.

public ref class TemplateDefinition : System::Web::UI::Design::DesignerObject

public class TemplateDefinition : System.Web.UI.Design.DesignerObject

type TemplateDefinition = class
    inherit DesignerObject

Public Class TemplateDefinition
Inherits DesignerObject

Наследование

Object

DesignerObject

TemplateDefinition

Примеры

В следующем примере кода показано, как наследовать пользовательский класс из ControlDesigner класса . Этот конструктор элементов управления поддерживает элемент управления с четырьмя возможными шаблонами.

Чтобы попробовать его, добавьте ссылку на сборку System.Design.dll, скомпилируйте код, а затем в узле разработки, например Visual Studio 2005, просмотрите страницу в режиме конструктора. Выберите элемент управления, щелкните список действий, чтобы выбрать шаблон для изменения, а затем используйте функцию перетаскивания для перемещения элементов управления в шаблон.

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

namespace ASPNet.Design.Samples
{
    // Set an attribute reference to the designer, and define 
    // the HTML markup that the toolbox will write into the source.
    [Designer(typeof(TemplateGroupsSampleDesigner)),
        ToolboxData("<{0}:TemplateGroupsSample runat=server></{0}:TemplateGroupsSample>")]
    public sealed class TemplateGroupsSample : WebControl, INamingContainer
    {
        // Field for the templates
        private ITemplate[] _templates;

        // Constructor
        public TemplateGroupsSample()
        {
            _templates = new ITemplate[4];
        }

        // For each template property, set the designer attributes 
        // so the property does not appear in the property grid, but 
        // changes to the template are persisted in the control.
        [Browsable(false),
            PersistenceMode(PersistenceMode.InnerProperty)]
        public ITemplate Template1
        {
            get { return _templates[0]; }
            set { _templates[0] = value; }
        }
        [Browsable(false),
            PersistenceMode(PersistenceMode.InnerProperty)]
        public ITemplate Template2
        {
            get { return _templates[1]; }
            set { _templates[1] = value; }
        }
        [Browsable(false),
            PersistenceMode(PersistenceMode.InnerProperty)]
        public ITemplate Template3
        {
            get { return _templates[2]; }
            set { _templates[2] = value; }
        }
        [Browsable(false),
            PersistenceMode(PersistenceMode.InnerProperty)]
        public ITemplate Template4
        {
            get { return _templates[3]; }
            set { _templates[3] = value; }
        }

        protected override void CreateChildControls()
        {
            // Instantiate each template inside a panel
            // then add the panel to the Controls collection
            for (int i = 0; i < 4; i++)
            {
                Panel pan = new Panel();
                _templates[i].InstantiateIn(pan);
                this.Controls.Add(pan);
            }
        }
    }

    // Designer for the TemplateGroupsSample control
    public class TemplateGroupsSampleDesigner : ControlDesigner
    {
        TemplateGroupCollection col = null;

        public override void Initialize(IComponent component)
        {
            // Initialize the base
            base.Initialize(component);
            // Turn on template editing
            SetViewFlags(ViewFlags.TemplateEditing, true);
        }

        // Add instructions to the placeholder view of the control
        public override string GetDesignTimeHtml()
        {
            return CreatePlaceHolderDesignTimeHtml("Click here and use " +
                "the task menu to edit the templates.");
        }

        public override TemplateGroupCollection TemplateGroups
        {
            get
            {

                if (col == null)
                {
                    // Get the base collection
                    col = base.TemplateGroups;

                    // Create variables
                    TemplateGroup tempGroup;
                    TemplateDefinition tempDef;
                    TemplateGroupsSample ctl;

                    // Get reference to the component as TemplateGroupsSample
                    ctl = (TemplateGroupsSample)Component;

                    // Create a TemplateGroup
                    tempGroup = new TemplateGroup("Template Set A");

                    // Create a TemplateDefinition
                    tempDef = new TemplateDefinition(this, "Template A1", 
                        ctl, "Template1", true);

                    // Add the TemplateDefinition to the TemplateGroup
                    tempGroup.AddTemplateDefinition(tempDef);

                    // Create another TemplateDefinition
                    tempDef = new TemplateDefinition(this, "Template A2", 
                        ctl, "Template2", true);

                    // Add the TemplateDefinition to the TemplateGroup
                    tempGroup.AddTemplateDefinition(tempDef);

                    // Add the TemplateGroup to the TemplateGroupCollection
                    col.Add(tempGroup);

                    // Create another TemplateGroup and populate it
                    tempGroup = new TemplateGroup("Template Set B");
                    tempDef = new TemplateDefinition(this, "Template B1", 
                        ctl, "Template3", true);
                    tempGroup.AddTemplateDefinition(tempDef);
                    tempDef = new TemplateDefinition(this, "Template B2", 
                        ctl, "Template4", true);
                    tempGroup.AddTemplateDefinition(tempDef);

                    // Add the TemplateGroup to the TemplateGroupCollection
                    col.Add(tempGroup);
                }

                return col;
            }
        }

        // Do not allow direct resizing unless in TemplateMode
        public override bool AllowResize
        {
            get
            {
                if (this.InTemplateMode)
                    return true;
                else
                    return false;
            }
        }
    }
}

Imports System.ComponentModel
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.Design

Namespace ASPNet.Design.Samples

    ' Set an attribute reference to the designer, and define 
    ' the HTML markup that the toolbox will write into the source.
    <Designer(GetType(TemplateGroupsSampleDesigner)), _
        ToolboxData("<{0}:TemplateGroupsSample runat=server></{0}:TemplateGroupsSample>")> _
    Public Class TemplateGroupsSample
        Inherits WebControl
        Implements INamingContainer

        ' Field for the templates
        Private _templates() As ITemplate

        ' Constructor
        Public Sub New()
            ReDim _templates(4)
        End Sub

        ' For each template property, set the designer attributes 
        ' so the property does not appear in the property grid, but 
        ' changes to the template are persisted in the control.
        <Browsable(False), _
            PersistenceMode(PersistenceMode.InnerProperty)> _
        Public Property Template1() As ITemplate
            Get
                Return _templates(0)
            End Get
            Set(ByVal Value As ITemplate)
                _templates(0) = Value
            End Set
        End Property
        <Browsable(False), _
            PersistenceMode(PersistenceMode.InnerProperty)> _
        Public Property Template2() As ITemplate
            Get
                Return _templates(1)
            End Get
            Set(ByVal Value As ITemplate)
                _templates(1) = Value
            End Set
        End Property
        <Browsable(False), _
            PersistenceMode(PersistenceMode.InnerProperty)> _
        Public Property Template3() As ITemplate
            Get
                Return _templates(2)
            End Get
            Set(ByVal Value As ITemplate)
                _templates(2) = Value
            End Set
        End Property
        <Browsable(False), _
            PersistenceMode(PersistenceMode.InnerProperty)> _
        Public Property Template4() As ITemplate
            Get
                Return _templates(3)
            End Get
            Set(ByVal Value As ITemplate)
                _templates(3) = Value
            End Set
        End Property

        Protected Overrides Sub CreateChildControls()
            ' Instantiate the template inside the panel
            ' then add the panel to the Controls collection
            Dim i As Integer

            For i = 0 To 3
                Dim pan As New Panel()
                _templates(i).InstantiateIn(pan)
                Me.Controls.Add(pan)
            Next
        End Sub

    End Class

    ' Designer for the TemplateGroupsSample class
    Public Class TemplateGroupsSampleDesigner
        Inherits System.Web.UI.Design.ControlDesigner

        Private col As TemplateGroupCollection = Nothing

        Public Overrides Sub Initialize(ByVal Component As IComponent)
            ' Initialize the base
            MyBase.Initialize(Component)
            ' Turn on template editing
            SetViewFlags(ViewFlags.TemplateEditing, True)
        End Sub

        ' Add instructions to the placeholder view of the control
        Public Overloads Overrides Function GetDesignTimeHtml() As String
            Return CreatePlaceHolderDesignTimeHtml("Click here and use " & _
                "the task menu to edit the templates.")
        End Function

        Public Overrides ReadOnly Property TemplateGroups() As TemplateGroupCollection
            Get
                If IsNothing(col) Then
                    ' Get the base collection
                    col = MyBase.TemplateGroups

                    ' Create variables
                    Dim tempGroup As TemplateGroup
                    Dim tempDef As TemplateDefinition
                    Dim ctl As TemplateGroupsSample

                    ' Get reference to the component as TemplateGroupsSample
                    ctl = CType(Component, TemplateGroupsSample)

                    ' Create a TemplateGroup
                    tempGroup = New TemplateGroup("Template Set A")

                    ' Create a TemplateDefinition
                    tempDef = New TemplateDefinition(Me, "Template A1", ctl, "Template1", True)

                    ' Add the TemplateDefinition to the TemplateGroup
                    tempGroup.AddTemplateDefinition(tempDef)

                    ' Create another TemplateDefinition
                    tempDef = New TemplateDefinition(Me, "Template A2", ctl, "Template2", True)

                    ' Add the TemplateDefinition to the TemplateGroup
                    tempGroup.AddTemplateDefinition(tempDef)

                    ' Add the TemplateGroup to the TemplateGroupCollection
                    col.Add(tempGroup)

                    ' Create another TemplateGroup and populate it
                    tempGroup = New TemplateGroup("Template Set B")
                    tempDef = New TemplateDefinition(Me, "Template B1", ctl, "Template3", True)
                    tempGroup.AddTemplateDefinition(tempDef)
                    tempDef = New TemplateDefinition(Me, "Template B2", ctl, "Template4", True)
                    tempGroup.AddTemplateDefinition(tempDef)

                    ' Add the TemplateGroup to the TemplateGroupCollection
                    col.Add(tempGroup)
                End If

                Return col
            End Get
        End Property

        ' Do not allow direct resizing unless in TemplateMode
        Public Overrides ReadOnly Property AllowResize() As Boolean
            Get
                If Me.InTemplateMode Then
                    Return True
                Else
                    Return False
                End If
            End Get
        End Property
    End Class
End Namespace

<%@ Page Language="VB" %>
<%@ Register TagPrefix="aspSample" 
    Namespace="ASPNet.Design.Samples" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
    
       <aspSample:TemplateGroupsSample runat="server" ID="TGSample1">
       </aspSample:TemplateGroupsSample>
    
    </div>
    </form>
</body>
</html>

Комментарии

Класс TemplateDefinition предоставляет базовый класс определения шаблона, который можно наследовать от и расширить для конструктора элементов управления, чтобы обеспечить поддержку шаблонных элементов управления в узле разработки, например Visual Studio 2005. Узел разработки использует свойства и методы TemplateDefinition класса для упрощения создания и редактирования шаблона во время разработки.

Конструкторы

TemplateDefinition(ControlDesigner, String, Object, String)	Инициализирует новый экземпляр класса TemplateDefinition, используя предоставленный конструктор, имя шаблона, шаблон и имя свойства.
TemplateDefinition(ControlDesigner, String, Object, String, Boolean)	Инициализирует новый экземпляр класса TemplateDefinition, используя предоставленный конструктор, имя шаблона, шаблон, имя свойства и то, ограничивается ли содержимое шаблона элементами управления веб-сервера.
TemplateDefinition(ControlDesigner, String, Object, String, Style)	Инициализирует новый экземпляр класса TemplateDefinition, используя предоставленный конструктор, имя шаблона, шаблон, имя свойства и объект Style.
TemplateDefinition(ControlDesigner, String, Object, String, Style, Boolean)	Инициализирует новый экземпляр класса TemplateDefinition, используя предоставленный конструктор, имя шаблона, шаблон, имя свойства, объект Style и то, ограничивается ли содержимое шаблона элементами управления веб-сервера.

Свойства

AllowEditing	Возвращает значение, указывающее, должен ли шаблон разрешить редактирование своего содержания.
Content	Возвращает или задает разметку HTML, представляющую содержимое шаблона.
Designer	Возвращает связанный компонент конструктора. (Унаследовано от DesignerObject)
Name	Возвращает имя объекта. (Унаследовано от DesignerObject)
Properties	Возвращает свойства объекта. (Унаследовано от DesignerObject)
ServerControlsOnly	Возвращает значение, показывающее, должно ли содержимое шаблона ограничиваться элементами управления веб-сервера, как задано в конструкторе TemplateDefinition. Это свойство доступно только для чтения.
Style	Возвращает стиль, который должен применяться к шаблону в соответствии с установками в конструкторе TemplateDefinition. Это свойство доступно только для чтения.
SupportsDataBinding	Возвращает или устанавливает значение, показывающее, поддерживает ли шаблон привязку данных.
TemplatedObject	Возвращает компонент, в котором находится шаблон. Это свойство доступно только для чтения.
TemplatePropertyName	Возвращает имя свойства для шаблона, которое узел разработки должен выводить в сетке свойств.

Методы

Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetService(Type)	Возвращает службу из узла разработки, как определено предоставленным типом. (Унаследовано от DesignerObject)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

Явные реализации интерфейса

IServiceProvider.GetService(Type)

Описание этого члена см. в разделе GetService(Type). (Унаследовано от DesignerObject)

Методы расширения

GetKeyedService<T>(IServiceProvider, Object)	Получает службу типа T из IServiceProvider.
GetKeyedServices(IServiceProvider, Type, Object)	Получает перечисление служб типа serviceType из IServiceProvider.
GetKeyedServices<T>(IServiceProvider, Object)	Получает перечисление служб типа T из IServiceProvider.
GetRequiredKeyedService(IServiceProvider, Type, Object)	Получает службу типа serviceType из IServiceProvider.
GetRequiredKeyedService<T>(IServiceProvider, Object)	Получает службу типа T из IServiceProvider.
CreateAsyncScope(IServiceProvider)	Создает интерфейс AsyncServiceScope, который может использоваться для разрешения служб с ограниченной областью.
CreateScope(IServiceProvider)	Создает интерфейс IServiceScope, который может использоваться для разрешения служб с ограниченной областью.
GetRequiredService(IServiceProvider, Type)	Возвращает службу типа serviceType из IServiceProvider.
GetRequiredService<T>(IServiceProvider)	Возвращает службу типа T из IServiceProvider.
GetService<T>(IServiceProvider)	Возвращает службу типа T из IServiceProvider.
GetServices(IServiceProvider, Type)	Возвращает перечисление служб типа serviceType из IServiceProvider.
GetServices<T>(IServiceProvider)	Возвращает перечисление служб типа T из IServiceProvider.
GetFakeLogCollector(IServiceProvider)	Возвращает объект , который собирает записи журнала, отправляемые в поддельные средства ведения журнала.
GetFakeRedactionCollector(IServiceProvider)	Возвращает экземпляр сборщика поддельных средств редактирования из контейнера внедрения зависимостей.

См. также раздел

• ControlDesigner
• TemplateGroups
• TemplatedControlDesigner
• Расширение поддержки времени разработки
• Практическое руководство. Расширение внешнего вида и функциональности элементов управления в режиме конструктора