Симон Робинсон - C# для профессионалов. Том II

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

Теперь, пока библиотека PCSCustomWebControlsсконфигурирована как приложение запуска, можно нажать кнопку Debug, чтобы увидеть результаты работы:

Добавим также ссылку на проект PCSCustomWebControlsв раздел тестирования приложений:

Затем добавим инструкцию usingв пространство имен PCSCustomWebControlsTestAppв WebForm1.aspx.cs:

using PCSCustomWebControls;

Это позволит нам использовать наши специальные элементы управления из кода, скрытого за формой.

Как можно предположить из результатов предыдущего раздела, образец элемента управления, создаваемый по умолчанию, является версией стандартного элемента управления . Создаваемый в файле .csкод проекта, WebCustomControl1.cs, выглядит следующим образом:

namespace PCSCustomWebControls {

using System;

using System.Web.UI;

using System.Web.UI.WebControls;

using System.ComponentModel;

///

/// Краткое описание WebCustomControl1

///

[DefaultProperty("Text"),

ToolboxData("<{0}WebCustomControl1 runat=server></{0}:WebCustomControl1>")]

public class WebCustomControl1 : System.Web.UI.WebControls.WebControl {

private string text;

[Bindable(true), Category("Appearance"), DefaultValue(" ")]

public string Text {

get {

return text;

}

set {

text = value;

}

}

///

/// Предоставить этот элемент управления указанному параметру вывода.

///

/// The HTML writer to write out to

protected override void Render(HtmlTextWriter output) {

output.Write(Text);

}

}

}

Начальные инструкции usingдля пространств имен вполне стандартны.

Здесь определен единственный класс WebCustomControl1(отметим, как имя класса отображается прямо в элемент ASP.NET в простом примере, только что увиденном), который является производным из класса WebControl, как обсуждалось ранее. Для этого класса предоставлены два атрибута: DefaultPropertyи ToolboxData. Атрибут DefaultPropertyопределяет, какое свойство будет использоваться по умолчанию для элемента управления в языках, которые поддерживают эту функциональность. Атрибут ToolboxDataточно определяет, какой код HTML будет добавлен к странице .aspx, если этот элемент управления добавляется с помощью инструментальной панели Visual Studio (когда проект откомпилирован, можно добавить элемент управления в панель инструментов, конфигурируя панель инструментов для использования созданной сборки).

Класс содержит одно свойство: Text. Это очень простое текстовое свойство, похожее на те, которые встречались раньше. Здесь необходимо отметить только три атрибута:

□ Bindable— показывает, может ли свойство быть связано с данными.

□ Category— задает, будет ли свойство выводиться на страницах свойств.

□ DefaultValue— значение по умолчанию для свойства.

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

Остальная часть класса состоит из метода Render(). Это единственный самый важный метод для реализации при создании специальных элементов управления, так как в нем мы получаем доступ к потоку вывода для изображения содержимого элемента управления. Существует только два случая, когда этот метод не нужно реализовывать:

□ Когда создается элемент управления, не имеющий визуального представления (обычно называемый компонентом).

□ Когда создается производный элемент из существующего элемента управления и не требуется изменять характеристики его изображения.

Специальные элементы управления могут также предоставлять специальные методы, инициировать специальные события, и отвечать производным элементам управления (если они существуют). Ниже мы рассмотрим: