TemplateGroupCollection Kelas

Referensi

Definisi

Ruang nama:: System.Web.UI.Design

Rakitan:: System.Design.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mewakili kumpulan TemplateGroup objek dalam perancang kontrol. Kelas ini tidak dapat diwariskan.

public ref class TemplateGroupCollection sealed : System::Collections::IList

public sealed class TemplateGroupCollection : System.Collections.IList

type TemplateGroupCollection = class
    interface IList
    interface ICollection
    interface IEnumerable

Public NotInheritable Class TemplateGroupCollection
Implements IList

Warisan: Object
TemplateGroupCollection

Penerapan: ICollection IEnumerable IList

Contoh

Contoh kode berikut menunjukkan cara menentukan perancang kontrol sederhana yang berasal dari ControlDesigner kelas . Perancang kontrol turunan mengimplementasikan TemplateGroups properti dengan mendapatkan grup templat yang ditentukan untuk kelas dasar dan menambahkan grup templat yang khusus untuk perancang kontrol turunan.

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

namespace Examples.AspNet
{
    // Define a simple control designer that adds a
    // template group to the template group collection.
    class DerivedControlDesigner : System.Web.UI.Design.ControlDesigner
    {
        private DerivedControl internalControl = null;

        private const String templateGroupName = "My template group";
        private const String templateDefinitionName1 = "First";
        private const String templateDefinitionName2 = "Second";
        private TemplateGroup internalGroup = null;

        // Override the read-only TemplateGroups property.
        // Get the base group collection, and add a group 
        // with two template definitions for the derived
        // control designer.
        public override TemplateGroupCollection TemplateGroups
        {
            get
            {
                // Start with the groups defined by the base designer class.
                TemplateGroupCollection groups = base.TemplateGroups;

                if (internalGroup == null) 
                {
                    // Define a new group with two template definitions.
                    internalGroup = new TemplateGroup(templateGroupName, 
                                                internalControl.ControlStyle);

                    TemplateDefinition templateDef1 = new TemplateDefinition(this, 
                        templateDefinitionName1, internalControl, 
                        templateDefinitionName1, internalControl.ControlStyle);

                    TemplateDefinition templateDef2 = new TemplateDefinition(this, 
                        templateDefinitionName2, internalControl, 
                        templateDefinitionName2, internalControl.ControlStyle);

                    internalGroup.AddTemplateDefinition(templateDef1);
                    internalGroup.AddTemplateDefinition(templateDef2);
                }

                // Add the new template group to the collection.
                groups.Add(internalGroup);

                return groups;
            }
        }
    }

    // Define a simple web control, and associate it with the designer.
    [DesignerAttribute(typeof(DerivedControlDesigner),
                       typeof(IDesigner))]
    public class DerivedControl : WebControl
    {
        // Define derived control behavior here.
    }
}

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

Namespace Examples.AspNet

    ' Define a simple control designer that adds a
    ' template group to the template group collection.
    Class DerivedControlDesigner
        Inherits System.Web.UI.Design.ControlDesigner

        Private Dim internalControl As DerivedControl = Nothing
    
        Private Const templateGroupName As String = "My template group"
        Private Const templateDefinitionName1 As String = "First"
        Private Const templateDefinitionName2 As String = "Second"
        Private Dim internalGroup As TemplateGroup = Nothing

        ' Override the read-only TemplateGroups property.
        ' Get the base group collection, and add a group 
        ' with two template definitions for the derived
        ' control designer.
        Public Overrides ReadOnly Property TemplateGroups As TemplateGroupCollection
            Get

                ' Start with the groups defined by the base designer class.
                Dim groups As TemplateGroupCollection  = MyBase.TemplateGroups

                If internalGroup Is Nothing

                    ' Define a new group with two template definitions.
                    internalGroup = New TemplateGroup(templateGroupName, _
                                                internalControl.ControlStyle)

                    Dim templateDef1 As TemplateDefinition = new TemplateDefinition(Me, _
                        templateDefinitionName1, internalControl, _
                        templateDefinitionName1, internalControl.ControlStyle)

                    Dim templateDef2 As TemplateDefinition = new TemplateDefinition(Me, _
                        templateDefinitionName2, internalControl, _
                        templateDefinitionName2, internalControl.ControlStyle)

                    internalGroup.AddTemplateDefinition(templateDef1)
                    internalGroup.AddTemplateDefinition(templateDef2)

                End If

                ' Add the new template group to the collection.
                groups.Add(internalGroup)

                return groups
            End Get
        End Property

    End Class

    ' Simple Web control, derived from the Web control class.
    <DesignerAttribute(GetType(DerivedControlDesigner), GetType(IDesigner))> _
    Public Class DerivedControl
        Inherits WebControl
        
        ' Define derived control behavior here.
    End Class

End Namespace

Keterangan

Kelas ControlDesigner , dan kelas turunan apa pun, mendefinisikan TemplateGroups properti sebagai TemplateGroupCollection objek . Properti TemplateGroupCollection biasanya hanya digunakan oleh host desain seperti Visual Studio 2005.

Koleksi secara dinamis meningkat ukurannya saat objek ditambahkan. Indeks dalam koleksi ini berbasis nol. Count Gunakan properti untuk menentukan berapa banyak grup dalam koleksi.

Selain itu, gunakan TemplateGroupCollection metode dan properti untuk menyediakan fungsionalitas berikut:

Metode Add untuk menambahkan satu grup ke koleksi.
Metode Insert untuk menambahkan grup pada indeks tertentu dalam koleksi.
Metode Remove untuk menghapus grup.
Metode RemoveAt untuk menghapus grup pada indeks tertentu.
Metode Contains untuk menentukan apakah grup tertentu sudah ada dalam koleksi.
Metode IndexOf untuk mengambil indeks grup dalam koleksi.
Pengindeks Item[] untuk mendapatkan atau mengatur grup pada indeks tertentu, menggunakan notasi array.
Metode AddRange untuk menambahkan beberapa grup ke koleksi.

Anda dapat menambahkan beberapa grup baik sebagai array grup atau sebagai TemplateGroupCollection objek yang Anda ambil melalui TemplateGroups properti perancang kontrol lain.
Metode Clear untuk menghapus semua grup dari koleksi.

Konstruktor

TemplateGroupCollection()

Menginisialisasi instans baru kelas TemplateGroupCollection.

Properti

Count	Mendapatkan jumlah TemplateGroup objek dalam koleksi.
Item[Int32]	Mendapatkan atau mengatur TemplateGroup objek pada indeks yang ditentukan dalam koleksi.

Metode

Add(TemplateGroup)	Menambahkan objek yang ditentukan TemplateGroup ke akhir koleksi.
AddRange(TemplateGroupCollection)	Menambahkan grup templat dalam objek yang sudah ada TemplateGroupCollection ke objek saat ini TemplateGroupCollection .
Clear()	Menghapus semua grup dari koleksi.
Contains(TemplateGroup)	Menentukan apakah grup yang ditentukan terkandung dalam koleksi.
CopyTo(TemplateGroup[], Int32)	Menyalin grup dalam koleksi ke array satu dimensi yang kompatibel, dimulai dari indeks array target yang ditentukan.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
IndexOf(TemplateGroup)	Mengembalikan indeks objek yang ditentukan TemplateGroup dalam koleksi.
Insert(Int32, TemplateGroup)	TemplateGroup Menyisipkan objek ke dalam koleksi pada indeks yang ditentukan.
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
Remove(TemplateGroup)	Menghapus objek yang ditentukan TemplateGroup dari koleksi.
RemoveAt(Int32)	TemplateGroup Menghapus objek pada indeks yang ditentukan dalam koleksi.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Implementasi Antarmuka Eksplisit

ICollection.CopyTo(Array, Int32)	Untuk deskripsi anggota ini, lihat CopyTo(Array, Int32).
ICollection.Count	Untuk deskripsi anggota ini, lihat Count.
ICollection.IsSynchronized	Untuk deskripsi anggota ini, lihat IsSynchronized.
ICollection.SyncRoot	Untuk deskripsi anggota ini, lihat SyncRoot.
IEnumerable.GetEnumerator()	Untuk deskripsi anggota ini, lihat GetEnumerator().
IList.Add(Object)	Untuk deskripsi anggota ini, lihat Add(Object).
IList.Clear()	Untuk deskripsi anggota ini, lihat Clear().
IList.Contains(Object)	Untuk deskripsi anggota ini, lihat Contains(Object).
IList.IndexOf(Object)	Untuk deskripsi anggota ini, lihat IndexOf(Object).
IList.Insert(Int32, Object)	Untuk deskripsi anggota ini, lihat Insert(Int32, Object).
IList.IsFixedSize	Untuk deskripsi anggota ini, lihat IsFixedSize.
IList.IsReadOnly	Untuk deskripsi anggota ini, lihat IsReadOnly.
IList.Item[Int32]	Untuk deskripsi anggota ini, lihat IList kelas .
IList.Remove(Object)	Untuk deskripsi anggota ini, lihat Remove(Object).
IList.RemoveAt(Int32)	Untuk deskripsi anggota ini, lihat RemoveAt(Int32).

Metode Ekstensi

Cast<TResult>(IEnumerable)	Mentransmisikan elemen dari ke IEnumerable jenis yang ditentukan.
OfType<TResult>(IEnumerable)	Memfilter elemen berdasarkan IEnumerable jenis yang ditentukan.
AsParallel(IEnumerable)	Mengaktifkan paralelisasi kueri.
AsQueryable(IEnumerable)	Mengonversi menjadi IEnumerable IQueryable.

Berlaku untuk

Bagikan melalui