Bagikan melalui


TemplateDefinition Kelas

Definisi

Menyediakan properti dan metode yang menentukan elemen templat dalam kontrol server Web pada waktu desain.

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
Warisan
TemplateDefinition

Contoh

Contoh kode berikut menunjukkan cara mendapatkan kelas kustom dari ControlDesigner kelas . Perancang kontrol ini mendukung kontrol dengan empat templat yang mungkin.

Untuk mencobanya, tambahkan referensi ke rakitan System.Design.dll, kompilasi kode, lalu, di host desain seperti Visual Studio 2005, lihat halaman dalam tampilan Desain. Pilih kontrol, klik daftar tindakan untuk memilih templat yang akan diubah, lalu gunakan fitur seret dan letakkan untuk memindahkan kontrol ke dalam templat.

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>

Keterangan

Kelas ini TemplateDefinition menyediakan kelas definisi templat dasar yang dapat diwarisi dari dan diperluas untuk digunakan perancang kontrol dalam memberikan dukungan untuk kontrol templat dalam host desain seperti Visual Studio 2005. Host desain menggunakan properti dan metode kelas untuk memfasilitasi TemplateDefinition pembuatan dan pengeditan templat pada waktu desain.

Konstruktor

TemplateDefinition(ControlDesigner, String, Object, String)

Menginisialisasi instans TemplateDefinition baru kelas, menggunakan perancang, nama templat, templat, dan nama properti yang disediakan.

TemplateDefinition(ControlDesigner, String, Object, String, Boolean)

Menginisialisasi instans TemplateDefinition baru kelas , menggunakan perancang yang disediakan, nama templat, templat, nama properti, dan apakah akan membatasi konten templat ke kontrol server Web.

TemplateDefinition(ControlDesigner, String, Object, String, Style)

Menginisialisasi instans TemplateDefinition baru kelas, menggunakan perancang, nama templat, templat, nama properti, dan Style objek yang disediakan.

TemplateDefinition(ControlDesigner, String, Object, String, Style, Boolean)

Menginisialisasi instans TemplateDefinition baru kelas, menggunakan perancang yang disediakan, nama templat, templat, nama properti, Style objek, dan apakah akan membatasi konten ke kontrol server Web.

Properti

AllowEditing

Mendapatkan nilai yang menunjukkan apakah templat harus mengaktifkan pengeditan kontennya.

Content

Mendapatkan atau mengatur markup HTML yang mewakili konten templat.

Designer

Mendapatkan komponen perancang terkait.

(Diperoleh dari DesignerObject)
Name

Mendapatkan nama objek .

(Diperoleh dari DesignerObject)
Properties

Mendapatkan properti objek.

(Diperoleh dari DesignerObject)
ServerControlsOnly

Mengambil nilai yang menunjukkan apakah templat harus membatasi konten ke kontrol server Web, seperti yang diatur dalam TemplateDefinition konstruktor. Properti ini bersifat hanya baca.

Style

Mengambil gaya yang harus diterapkan ke templat sebagaimana diatur dalam TemplateDefinition konstruktor. Properti ini bersifat hanya baca.

SupportsDataBinding

Mengambil atau menetapkan nilai yang menunjukkan apakah templat mendukung pengikatan data.

TemplatedObject

Mengambil komponen tempat templat berada. Properti ini bersifat hanya baca.

TemplatePropertyName

Mengambil nama properti untuk templat yang harus ditampilkan host desain di kisi properti.

Metode

Equals(Object)

Menentukan apakah objek yang ditentukan sama dengan objek saat ini.

(Diperoleh dari Object)
GetHashCode()

Berfungsi sebagai fungsi hash default.

(Diperoleh dari Object)
GetService(Type)

Mendapatkan layanan dari host desain, seperti yang diidentifikasi oleh jenis yang disediakan.

(Diperoleh dari DesignerObject)
GetType()

Mendapatkan dari instans Type saat ini.

(Diperoleh dari Object)
MemberwiseClone()

Membuat salinan dangkal dari saat ini Object.

(Diperoleh dari Object)
ToString()

Mengembalikan string yang mewakili objek saat ini.

(Diperoleh dari Object)

Implementasi Antarmuka Eksplisit

IServiceProvider.GetService(Type)

Untuk deskripsi anggota ini, lihat GetService(Type).

(Diperoleh dari DesignerObject)

Metode Ekstensi

GetKeyedService<T>(IServiceProvider, Object)

Mendapatkan layanan jenis T dari IServiceProvider.

GetKeyedServices(IServiceProvider, Type, Object)

Mendapatkan enumerasi layanan jenis serviceType dari IServiceProvider.

GetKeyedServices<T>(IServiceProvider, Object)

Mendapatkan enumerasi layanan jenis T dari IServiceProvider.

GetRequiredKeyedService(IServiceProvider, Type, Object)

Mendapatkan layanan jenis serviceType dari IServiceProvider.

GetRequiredKeyedService<T>(IServiceProvider, Object)

Mendapatkan layanan jenis T dari IServiceProvider.

CreateAsyncScope(IServiceProvider)

Membuat baru AsyncServiceScope yang dapat digunakan untuk mengatasi layanan terlingkup.

CreateScope(IServiceProvider)

Membuat baru IServiceScope yang dapat digunakan untuk mengatasi layanan terlingkup.

GetRequiredService(IServiceProvider, Type)

Dapatkan layanan jenis serviceType dari IServiceProvider.

GetRequiredService<T>(IServiceProvider)

Dapatkan layanan jenis T dari IServiceProvider.

GetService<T>(IServiceProvider)

Dapatkan layanan jenis T dari IServiceProvider.

GetServices(IServiceProvider, Type)

Dapatkan enumerasi layanan jenis serviceType dari IServiceProvider.

GetServices<T>(IServiceProvider)

Dapatkan enumerasi layanan jenis T dari IServiceProvider.

GetFakeLogCollector(IServiceProvider)

Mendapatkan objek yang mengumpulkan rekaman log yang dikirim ke pencatat palsu.

GetFakeRedactionCollector(IServiceProvider)

Mendapatkan instans kolektor redactor palsu dari kontainer injeksi dependensi.

Berlaku untuk

Lihat juga