Как создать пользовательский / серверный элемент управления ASP.NET, использующий список asp: ListItem в качестве дочерних элементов управления?

Question

Я хочу создать пользовательский / серверный элемент управления, который будет создан примерно так:

<my:MyListControl runat="server">
   <asp:ListItem Text="Test1" Value="Test1" />
   <asp:ListItem Text="Test2" Value="Test2" />
</my:MyListControl>

Я просто ищу здесь начало: Статьи или примеры кода.

От какого базового класса мне следует наследовать? Что переопределить?

Возможно, как настроить какие подпункты принимает мой элемент управления (my: ListItem вместо asp: ListItem).

Я хочу создать очень простой элемент управления крошкой для небольшого раздела моего сайта. У меня все это работает со стандартными элементами управления ASP.NET, но элементы добавляются в коде, что означает исправление орфографической ошибки или ошибки форматирования с перекомпиляцией, что не идеально.

EDIT:

Вот мой код с добавлением предложения Джоша ниже:

Namespace MySite.Controls Хлебные крошки частичного класса Наследует UserControl

    Private m_BreadCrumbs As New List(Of BreadCrumbItem)

    <PersistenceMode(PersistenceMode.InnerProperty)> _
    Public Property Items() As List(Of BreadCrumbItem)
        Get
            Return m_BreadCrumbs
        End Get
        Set(ByVal value As List(Of BreadCrumbItem))
            m_BreadCrumbs = value
        End Set
    End Property

    Private Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs) Handles MyBase.Load
        Bind()
    End Sub

    Private Sub Bind()
        lvCrumbs.DataSource = Items
        Me.DataBind()
    End Sub
End Class

Public Class BreadCrumbItem
    Private m_Text As String
    Public Property Text() As String
        Get
            Return m_Text
        End Get
        Set(ByVal value As String)
            m_Text = value
        End Set
    End Property

    Private m_Url As String
    Public Property Url() As String
        Get
            Return m_Url
        End Get
        Set(ByVal value As String)
            m_Url = value
        End Set
    End Property
End Class

Конечное пространство имен

Тогда код моей страницы выглядит так:

<%@ Page Language="VB" AutoEventWireup="false" Inherits="MySite.MyPage" Title="My Page" Codebehind="MyPage.aspx.vb" %>
<%@ Register TagPrefix="my" Namespace="MySite.Controls" Assembly="MySite" %>
<my:BreadCrumbs ID="breadcrumbs" runat="server">
    <Items>
        <my:BreadCrumbItem Text="Another page" Url="AnotherPage.aspx" />
    </Items>
</my:BreadCrumbs>

Answer 1

Вы можете добавить свойство в код пользовательского элемента управления, например:

[PersistenceMode(PersistenceMode.InnerProperty)]
public List<ListItem> Items
{
    get;
    set;
}

Ваша разметка будет:

<my:MyListControl runat="server">
  <Items>
    <asp:ListItem/>
  </Items>
</my:myListControl>

Чтобы сделать так, чтобы ListItem мог быть вашим собственным элементом списка (который я рекомендую делать вместо использования asp.net.) Вы захотите создать свой собственный класс.

Вот пример серверного элемента управления, который я использую (я удалил много шума как такового, это просто скелет):

   [ToolboxData("<{0}:Menubar runat=server></{0}:Menubar>")]
    [System.ComponentModel.DesignTimeVisible(false)]
    public class Menubar : WebControl, IPostBackEventHandler
    {

        private List<MenuItem> _menuItems = new List<MenuItem>();
        [PersistenceMode(PersistenceMode.InnerProperty)]
        public List<MenuItem> MenuItems
        {
            get
            {
                return _menuItems;
            }
        }

    }
    [ToolboxItem(false)]
    [ParseChildren(true, "MenuItems")]
    public class MenuItem
    {
        private string _clientClick;
        private List<MenuItem> _menuItems = new List<MenuItem>();

        [Localizable(true)]
        public string Title { get; set; }
        public string Href { get; set; }
        public string Id { get; set; }
        [PersistenceMode(PersistenceMode.InnerDefaultProperty)]
        public List<MenuItem> MenuItems
        {
            get { return _menuItems; }
            set { _menuItems = value; }
        }
    }

Теперь я могу использовать это как:

<my:Menubar runat="server" ID="menuBar">
    <MenuItems>
        <my:MenuItem Title="Save" Href="javascript:saveItem(this);"  />
        <my:MenuItem Title="Print" Href="javascript:void(0);">
            <MenuItems>
                <my:MenuItem Title="Preview" Href=""/>
                <my:MenuItem Title="To Pdf" Href="javascript:"/>
            </MenuItems>
        </my:MenuItem>
    </MenuItems>
</my:Menubar>

Answer 2

Используйте asp: Repeater, затем привяжите его к списку объектов, которые вы хотите использовать в своей хлебной крошке Вы можете использовать шаблон для настройки самих элементов и разделителей.