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

 }

}

Здесь мы переопределяем метод GetChildControlType() базового класса ControlBuilder чтобы он возвращал тип класса Option в ответ на тег с именем <Option>. Фактически, чтобы все работало в максимальном количестве ситуаций, мы ищем любое имя тега, которое оканчивается строкой "option" с буквами в верхнем или нижнем регистре.

Мы переопределяем также метод AppendLiteralString() так, чтобы любой промежуточный текст, включая пробелы, игнорировался и не вызывал никаких проблем.

Когда это сделано в предположении, что в StrawPoll нет никаких других элементов управления, мы будем иметь все элементы управления Option содержащимися в коллекции Controls из StrawPoll. Эта коллекция не будет содержать никаких других элементов управления.

Отметим, что построитель элементов управления использует коллекцию атрибутов. Чтобы использовать это добавим следующую инструкцию using в пространство имен:

using System.Collections;

Стиль StrawPoll

Прежде чем перейти к рассмотрению самого класса StrawPoll, необходимо рассмотреть еще один вопрос проектирования. StrawPoll должен выводиться в трех формах:

□ Только кнопки для голосования

□ Только результаты

□ Кнопки для голосования и результаты

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

public enum pollStyle {

 voteonly, valuesonly, voteandvalues

}

Как мы видели ранее, свойства, которые являются перечислениями, легко использовать, и мы можем применять текстовые имена в качестве значений атрибутов в ASP.NET.

Элемент управления StrawPoll

Теперь соберем все вместе. Для начала определим два свойства: Title дли вывода заголовка в элементе управления и PollStyle для хранения перечисления типа вывода. Оба они будут использовать ViewState для сохранения состояния:

[ ControlBuilderAttribute (typeof (StrawPollControlBuilder)) ]

[ ParseChildren(false) ]

public class StrawPoll : System.Web.UI.WebControls.WebContol, INamingContainer {

 private string title = "Straw Poll";

 private pollStyle currentPollStyle = pollStyle.voteandvalues;

 public string Title {

  get {

   return title;

  }

  set {

   title = value;

  }

 }

 public pollStyle PollStyle {

  get {

   return currentPollStyle;

  }

  set {

   currentPollStyle = value;

  }

 }

}

Остальная часть этого класса посвящена методу Render(). Он будет выводить весь элемент управления выборочного опроса вместе со всеми вариантами выбора, принимая в расчет используемый стиль опроса. Мы выводим кнопки голосования, вызывая метод RenderControl() производных элементов управления Option, и выводим результаты опроса графически и численно с помощью свойств Votes производных элементов управления Option для создания простого кода HTML.

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

protected override void Render(HtmlTextWriter writer) {

 Option CurrentOption;

 long iTotalVotes = 0;

 long iPercentage = 0;

 int iColumns = 2;

 // Начало таблицы, изображение таблицы

 if (currentPollStyle == pollStyle.voteandvalues) {

  iColumns = 3;

 }

 writer.Write("<TABLE border='1' bordercolor='black' bgcolor='#DDDDEB'" +

  " width= '90%' cellpadding='1' cellspacing='1'" + " align='center'>");

 writer.Write("<TR><TD colspan='" + iColumns + align='center'"

  + " bgcolor='#FFFFDD'>");

 writer.Write("<B>" + title + "</B></TD></TR>");

 if (Controls.Count == 0) {

  // текст по умолчанию, когда нет вариантов выбора

  writer.Write("<TR><TD bgcoLor='#FFFFDD'>No options to" + " display.</TR></TD>");

 } else {

  // Получить общее число голосов

  for (int iLoop = 0; iLoop < Controls.Count; iLoop++) {

   // Получить вариант выбора

   currentOption = (Option)Controls[iLoop];

   // Просуммировать результаты голосования

   iTotalVotes += currentOption.Votes;

  }

  // Вывести каждый вариант выбора

  for (int iLoop = 0; iLoop < Controls.Count; iLoop++) {

   // Получить вариант выбора

   currentOption = (Option)Controls[iLoop];

   // Поместить имя варианта выбора в первый столбец

   writer.Write("<TR><TD bgcolor='#FFFFDD' width="15%'> " +

    currentOption.Name + " </TD>");

   // Добавить вариант голосования во второй столбец,

   // если требуется

   if (currentPollStyle != pollStyle.valuesonly) {

    writer.Write("<TD width='1%' bgcolor='#FFFFDD'>"

     + "<FONT Color='#FFFVDD'>.</FONT>");

    currentOption.RenderControl(writer);

    writer.Write("<FONT Color = '#FFFFDD'>.</FONT></TD>");

   }

   // Поместить график, значение и проценты в третьем столбце,

   // если требуется

   if (currentPollStyle != pollStyle.voteonly) {

    if (iTotalVotes > 0) {

     iPercentage = (currentOption.Votes * 100) / iTotalVotes;

    } else {

     iPercentage = 0;

    }

    writer.Write("<ТD bgcolor='#FFFFDD'><TABLE width='100%'>"

     + "<TR><TD><TABLE border='1' bordercolor= 'black' "

     + " width= '100%' cellpadding='0' " + " cellspacing='0'>");

    writer.Write("<TR><TD bgcolor='red' width='" + iPercentage

     + "%'><FONT соlor='red'>.</FONT></TD>");

    writer.Write<"TD bgcolor='white' width='" + (100-iPercentage) +

     "%'><FONT color='white'>." +

     "</FONT></TD></TR></TABLE></TD>");

    writer.Write("<TD width='75'>" + сurrentOption.Votes +

     " (" + iPercentage + "%)</TD><TR></TABLE></TD>");

   }

   // Конец строки

   writer.Write("</TR>");

  }

  // показать общее тело голосов, если выводятся значения

  if (currentPollStyle != pollStyle.voteonly) {

   writer.Write("<TR><TD bgcolor='#FFFFDD' colspan='" +

    iColumns + "'>Total votes cast: " + iTotalVotes + "</TD></TR>");

  }

 }

 // Завершить таблицу

 writer.Write("</TABLE>");

}

Если выборочный опрос выводится в режиме voteonly, то голосование должно инициировать изменение изображения в режиме valuesonly. Чтобы сделать это, нам потребуется небольшое изменение в обработчике кнопки голосования в классе Option:

protected void btnVote_Click(object sender, System.EventArgs e) {

 Increment();

 StrawPoll parent = (StrawPoll)Parent;

 if (parent.PollStyle == pollStyle.voteonly) {

  parent.PollStyle = pollStyle.valuesonly;

 }

}

Теперь все готово к проведению голосования.

Добавление обработчика событий

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

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

public event EventHandler Voted;

protected void OnVoted(EventArgs e) {

 Voted(this, e);

}

Тогда, как только нам понадобиться инициировать событие, мы просто вызываем метод OnVoted(), передавая аргументы события.

Когда вызывается OnVoted(), инициируется событие, в соответствии с которым может действовать пользователь. Чтобы сделать это, пользователю необходимо зарегистрировать обработчик событий для этого события:

strawPoll1.Voted += new EventHandler(this.StrawPoll1_OnVoted);

Пользователь должен также предоставить код обработчика strawPoll1_OnVoted(). Мы слегка расширим этот метод, добавляя специальные аргументы для события, чтобы сделать доступным элемент управления Option, который инициирует событие. Назовем наш объект специального аргумента OptionEventArgs и определим его в StrawPoll.cs следующим образом:

public class OptionEventArgs : EventArgs {

 public Option originatingOption;

}

Добавляем дополнительное открытое поле в существующий класс EventArgs. Так как мы изменили используемые аргументы, нам потребуется также специализированная версия представителя EventHandler, которая может объявляться в пространстве имен PCSCustomWebControls следующим образом:

public delegate void Option EventHandler(object sender, OptionEventArgs e);

Можно использовать эти примеры в StrawPoll следующим образом:

public class StrawPoll : System.Web.UI.WebControls.WebControl, INamingContainer {