MsDropDown - это web-контрол, который позволяет просматривать список в виде выпадающего списка (по аналогии MasterEditorAjaxDropDown) с иконками для элементов списка.

Ниже показан пример отображения данного контрола на веб-форме.

Публичные свойства MsDropDown

Свойство	Описание
Items	Список элементов
SelectedItem	Выбранный элемент
ReadOnly	Флаг, отвечающий за разрешение/запрет манипуляций с контролом

MsDropDownItem и его свойства

Каждый Item (элемент списка) является экземпляром класса MsDropDownItem.

Свойство	Описание
Text	Основной текст, по которому можно идентифицировать объект в отображаемом списке
ImagePath	Путь до картинки, которую следует отображать рядом с текстом
Description	Описание, дополнительный текст, который будет расположен рядом с основным

Подключение

Подключение возможно через разметку страницы, наполнение списка доступно только вручную в коде. Для этого в разметке страницы .aspx надо добавить соответствующий контрол:

<ac:MsDropDown ID="<ID контрола>" ReadOnly="<False/True>" runat="server"/>

Использование

Использование MsDropDown (как и MasterEditorAjaxDropDown) уместно, когда заранее известно, что количество мастеровых объектов небольшое и нет потребности для их выбора поднимать отдельную форму выбора.

Пример кода

Для того чтобы получить список, продемонстрированный на картинке выше, следует сделать следующее:

Код .aspx-страницы:

<div class="clearfix">
    <asp:Label CssClass="descLbl" ID="ctrlTestMsDropDownLabel" runat="server" Text="Список" EnableViewState="False">
    </asp:Label>
    <ac:MsDropDown ID="ctrlTestMsDropDown" ReadOnly="False" runat="server"/>
</div>

Формирование списка элементов:

/// <summary>
/// Формирование списка элементов для <see cref="MsDropDown"/> при загрузке контрола.
/// </summary>
/// <param name="e">Параметры события.</param> 
protected void Page_Load(object sender, EventArgs e)
{
    // Создание списка элементов програмно.
    // Text - сновной текст, по которому можно идентифицировать объект в отображаемом списке.
    // ImagePath - путь до картинки, которую следует отображать рядом с текстом.
    // Description - дополнительный текст, который будет расположен рядом с основным.
    var item1 = new MsDropDownItem();
    item1.Text = "Первый";
    item1.ImagePath = "/Images/cat.png";
    item1.Description = "Элемент списка";

    var item2 = new MsDropDownItem();
    item2.Text = "Второй";
    item2.ImagePath = "/Images/dog.png";
    item2.Description = "Элемент списка";

    var item3 = new MsDropDownItem();
    item3.Text = "Третий";
    item3.ImagePath = "/Images/pig.png";
    item3.Description = "Элемент списка";

    // Добавление созданных элементов в контрол.
    ctrlTestMsDropDown.Items.Add(item1);
    ctrlTestMsDropDown.Items.Add(item2);
    ctrlTestMsDropDown.Items.Add(item3);
}