Лекции

Дополнительные возможности

basic — Wed, 10 Feb 2010 22:03:28 GMT

Дополнительные возможности
для компиляции С#
В настоящем приложении приводится список различных возможностей компи-
лятора С#, которыми можно воспользоваться при выполнении компиляции проек-
тов С# без использования возможностей Visual Studio.NET, либо, если нужно,
чтобы компилятор выполнил какие-либо операции, не поддерживаемые Visual
Studio.NET. Эти опции представлены в виде нескольких таблиц, где они сгруппи-
рованы в соответствии со своей категорией.
В первой таблице приводятся различные форматы файлов, которые могут вклю-
чаться в выходной поток компилятора:
Опция Назначение ч
Выполняется обработка комментариев, предназначенных для создания
XML-документации (помеченных тремя слэшами — / / / ) , и выходной
поток направляется в указанный файл.
Осуществляется компиляция кода, но не создается выходной файл; этот
режим может оказаться полезным для отладки, поскольку в нем можно
увидеть все предупреждения и сообщения об ошибках на консоли.
Позволяет задавать имя выходного файла. Если файл не задан, то ком-
пилятор создает стандартный .ехе-файл с тем же именем, что и исход-
ный файл (за исключением расширения).
Позволяет задавать формат выходного файла. У параметра <опция> су-
ществует четыре возможных значения:
• ехе: создается стандартный выполняемый файл (это значение
используется по умолчанию).
• library: создается программная библиотека (DLL).
• module: создается программный отсек (модуль, у которого
отсутствует манифест), который в дальнейшем добавляется к модулю
(с использованием /addmodule).
• winexe: создается выполняемый файл Windows.
/doc:<имяфайла>
/nooutput
/out:<имяфайла>
/target:<опция> /Ь:<опцпя>
Во всех случаях, кроме использования опции /target .-module, в создаваемый
ЕХЕ-файл будет включаться манифест (или в первую DLL, если ЕХЕ-файл не со-
здается). Заметим, что /target может быть сокращено до /t.
В следующей таблице приводятся опции, которые могут задаваться в командной
строке для определения режима оптимизации при компиляции.
858 Приложение С
Опция Назначение
/optimize<+ I -> /о<+ I -> Устанавливает или отменяет режим оптимизации, выполняемой
компилятором, чтобы создать меньший по объему, более быстрый
и более эффективный выходной код. По умолчанию такой режим
отменен. Для включения режима следует воспользоваться
следующим синтаксисом:
/optimize или /optimize*
Для отмены режима используется синтаксис:
/optimize-
В следующей таблице представлены опции для создания модулей .NET и обра-
щения к ним:
Опция Назначение
/addmodule:будут включены в указанный модуль. Если задается более одного отсека,
они отделяются друг от друга точкой с запятой. Эта опция не может
использоваться в Visual Studio.NET.
/nostdliix+ I -> Позволяет задать, следует или нет импортировать стандартную библиотеку
( m s c o r l i b . d l l ) , которая импортируется по умолчанию. Если вы желаете
реализовать собственное пространство имен System и классы, то можно
не импортировать стандартную библиотеку. Для этого используется
следующий синтаксис:
/nostdlib ИЛИ /nostdlib+
Синтаксис для импорта стандартной библиотеки:
/nostdlib-
/ге£егепсе:<имя модуля> Предназначен для импорта метаданных из файла модуля. Можно либо
/г:<имя модуля> задать полный путь к данному модулю, либо этот путь может быть задан
в переменной среды PATH, либо указать путь относительно текущего проекта.
Если задается более одного файла, то они разделяются точками с запятой.
В следующей таблице объясняются опции, которые применяются при отладке
и поиске ошибок:
Опция Назначение
/bugreport:<имя файла> Создает файл с заданным именем, в котором содержится вся информация
об ошибках, сгенерированная компилятором. В состав содержимого файла
входит:
• Копия исходного файла.
• Список опций компилятора.
• Информация о версии компилятора, об операционной системе и т. д.
• Весь выходной поток компилятора
• Описание обнаруженной проблемы и возможное решение
(при наличии такового)
Эта опция не может использоваться в Visual Studio.NET.
Дополнительные
Опция
возможности для компиляции С#
Назначение
859
Продолжение таблицы
/checked<+ I -> Позволяет определять, будет ли переполнение целых значений приводить
к возникновению ошибки во время выполнения. Это относится только
к тому коду, который находится вне области действия описателей checked
и unchecked. По умолчанию этот режим отключен. Синтаксис, включающий
режим контроля за переполнением, имеет вид:
/checked ИЛИ /checked+
Для отказа от контроля за переполнением следует использовать следующий
синтаксис:
/checked-
/debug<+ I ->
/debug:<опция>
/fullpaths
/nowarn:<номер>
/warn: <опция>
/•ю:<опция>
/warnaserror<+ I ->
Позволяет генерировать отладочную информацию.
Для этой цели используется синтаксис:
/debug ИЛИ /debug*
Для отмены режима используется следующий синтаксис:
/debug-
По умолчанию режим отладки не используется. Если задается вывод
отладочной информации, то имеются два варианта, касающиеся того,
какого типа отладочная информация будет генерироваться:
• /debug:full: позволяет присоединить отладчик к работающей программе
• /debug rpdbonly: позволяет осуществлять отладку исходного кода,
если программа запускается в отладчике, но будет выводить только
ассемблер, если выполняющаяся программа присоединена к отладчику.
Задает полный путь к файлу, в котором содержится ошибка.
Эта опция недоступна в Visual Studio.NET.
Не позволяет компилятору генерировать сообщения об ошибках с заданным
номером. Номер предупреждения, отказ от вывода которого задается,
определяется опцией <номер>. Если задается более одного номера,
то они разделяются запятыми. Эта опция недоступна в Visual Studio.NET.
Позволяет задавать минимальный уровень выводимых ошибок.
Имеются следующие возможности:
• 0: Отказ от вывода всех ошибок.
• 1: Вывод сообщений только о грубых ошибках.
• 2: Вывод сообщений о грубых ошибках
и об ошибках средней "тяжести".
• 3: Вывод сообщений о грубых ошибках,
об ошибках средней "тяжести"
и о незначительных ошибках.
• 4: Вывод сообщений обо всех ошибках,
включая информационные сообщения
Устанавливает режим, в котором все предупреждения трактуются
как ошибки. Для включения режима используется следующий синтаксис:
/warnaserror ИЛИ /warnaserror+
Для отмены режима следует использовать синтаксис:
/warnaserror-
По умолчанию режим не устанавливается.
860 Приложение С
Опция Назначение
/def л.пе<имя> Определяет символ препроцессора
/а<имя> с именем <имя>.
Таблица слева демонстрирует, как следует
задавать директивы препроцессора.
В следующей ниже таблице представлены
опции, связанные с использованием внешних
ресурсов:
Опция Назначение
/linkresourсе КУПЛЯ файла>
файла>
/resource:<имя файла>
/гез:<имя файла>
/Win32 icon :<имя файла>
/win32res:Позволяет создавать ссылку на указанный .NET-ресурс.
Имеет следующие два необязательных дополнительных параметра
(разделенных запятыми):
• i d e n t i f i e r : Логическое имя ресурса;
имя, которое будет использовано для загрузки ресурса
(по умолчанию используется <имя файла>).
• mimetype: Строка, представляющая тип носителя,
на котором находится ресурс (по умолчанию отсутствует).
Эта опция не может использоваться в Visual Studio.NET.
Внедряет указанный .NET-pecypc в выходной файл.
Имеет следующие два необязательных дополнительных параметра
(разделенных запятыми):
• i d e n t i f i e r : Логическое имя ресурса;
имя, которое будет использовано для загрузки ресурса
(по умолчанию используется <имя файла>).
• mimetype: Строка, представляющая тип носителя,
на котором находится ресурс (по умолчанию отсутствует).
Позволяет включить заданный файл с иконкой Win32 (Лео)
в выходной файл.
Позволяет включить заданный файл с ресурсом Win32 ( . r e s )
в выходной файл. Эта опция недоступна в Visual Studio.NET.
В заключительной таблице представлены остальные опции компилятора:
Опция Назначение
@<имя файла>
/baseaddress:<адрес>
/codepage:<идентификатор>
/help
/?
Позволяет задавать файл, где содержатся все опции компилятора
и исходные файлы, которые будут обрабатываться компилятором
таким образом, как если бы они были заданы в командной строке.
Позволяет задавать наиболее предпочтительный базовый адрес,
по которому будет загружаться DLL. Значение опции <адрес>
может быть представлено в десятичном, шестнадцатеричном
или восьмеричном виде.
Позволяет задавать страницу кодировки (значение, передаваемое
опцией <идентификатор>), которая должна использоваться для всех
файлов с исходным кодом в процессе компиляции. Эта опция
оказывается полезной, когда для файлов с кодами на С# используется
набор символов, отличный от используемого в системе по умолчанию.
Эта опция недоступна в Visual Studio.NET.
Помещает перечень опций компилятора в стандартный выходной
поток. Эта опция недоступна в Visual Studio.NET.
Дополнительные возможности для компиляции С# 861
Продолжение таблицы
Опция Назначение
/incremental<+ I ->
/incr<+ I ->
/main:<класс>
/nologo
/recurse:<директория\файл>
/unsafe
Позволяет осуществлять, последовательную компиляцию файлов
с исходным кодом, при которой компилируются только функции,
в которые были внесены какие-либо изменения с момента
предшествующей компиляции. Информация о состоянии
предшествующей компиляции сохраняется в двух файлах —
в файле с расширением .dbg (или в файле с расширением .pdb,
если установлен режим /debug), предназначенном для хранения
отладочной информации, и в файле с расширением . incr — здесь
сохраняется информация о состоянии. Для задания такого режима
можно воспользоваться одним из двух следующих вариантов
синтаксиса:
/incremental ИЛИ /incremental+
Чтобы отменить этот режим, следует использовать
следующий синтаксис:
/incremental-
По умолчанию этот режим не установлен.
Позволяет задавать местоположение основного метода Main (),
если в исходном коде таких методов несколько.
Позволяет отказаться от вывода "шапки" с информацией
о компиляторе. Эта опция недоступна в Visual Studio.NET.
Позволяет осуществлять поиск файлов, подлежащих компиляции,
внутри поддиректорий. Имеет две опции:
• <директория> (необязательная): определяет директорию
или поддиректорию, с которой следует начинать поиск.
Если эта опция не задана, то поиск осуществляется
с директории текущего проекта.
• <файл>: определяет файл или файлы, поиск которых
следует осуществлять.
Позволяет выполнять компиляцию кода, который помечен
ключевым словом unsafe.

Инсталляция MSDE

basic — Wed, 10 Feb 2010 22:02:52 GMT

Инсталляция MSDE
Предназначенные для работы при больших нагрузках системы управления БД
(database managemant system — DBMS) типа Oracle и Microsoft SQL Server по-
зволяют поддерживать выполнение десятков тысяч транзакций в минуту, при этом
сокращая до минимума время отключения для проведения работ по сопровожде-
нию и внесению изменений. Они представляют собой замечательный пример со-
временного программного обеспечения, однако за эту мощь приходится платить
определенную цену. Прежде всего — дороговизной таких систем DBMS, которая
начинается с несколько тысяч долларов и круто идет вверх при увеличении воз-
можностей. КрОхМе того, за применение систем DBMS промышленного использо-
вания приходится также расплачиваться памятью, мощностью процессора и объемом
памяти на жестком диске, которые необходимы для работы таких систем.
С точки зрения разработчиков установка такой полномасштабной системы на
переносных компьютерах для тестирования SQL-операторов может оказаться не-
возможной. Компания Microsoft предлагает определенную альтернативу — она
взяла продукт SQL Server и убрала все инструменты, предназначенные для управ-
ления и ведения разработок, оставив только ядро, отвечающее за работу с данными.
Затем они ограничили максимальное число пользователей — не более пяти, и объ-
ем данных — 2 гигабайта. Полученный в результате продукт получил название
MSDE (Microsoft Data Engine — ядро для работы с данными компании Microsoft).
Он вполне может использоваться в качестве серверной части, к которой совер-
шенно естественно могут добавляться клиентские с CD, что позволяет инсталли-
ровать менее масштабные варианты SQL Server.
Инсталляция Microsoft Data Engine (MSDE)
На дисках Office 2000 программа MSDE располагается на Disk 0ne\SQL\x86\
SETUP\SetupSQL.exe.
Если вы обладаете лицензией на какой-либо продукт Visual Products, то вы мо-
жете скачать MSDE С сайта http://insdn.microsoft.com/vstudio/insde/default.asp
или — по тому же самому адресу — сделать заказ, и CD будет выслан вам по поч-
те. Инсталляция продукта очень проста; требуется 50 Мбайт памяти на жестком
диске плюс собственно ваши данные. И хотя это всего лишь MSDE, а не Microsoft
SQL Server, приложение будет инсталлировано в папке C:\MSSQL7. Внутри этой
папки располагается папка Data, в которой вы сможете обнаружить базы данных,
устанавливаемые по умолчанию.
1. Весь процесс инсталляции занимает менее пятнадцати минут,
Начните с завершения всех работающих приложений.
Иъ MSDE
851
2. С помощью пункта меню
Start | Run | browse найдите выполняемый
файл setupSQL.exe и запустите его.
Для этого необходимо один раз
щелкнуть мышью на кнопке ОК,
чтобы покинуть окно поиска,
и второй раз щелкнуть на кнопке ОК
для запуска файла установки.
3. Будет запущен мастер инсталляции,
который попросит выбрать метод
инсталляции (см. рис. справа).
" Выберите опцию Local Install (локальная
инсталляция) и щелкните мышью
на кнопке Next.
5. Теперь мастер запросит информацию,
касающуюся вашего имени и вашей
компании (см. рис. справа). Введите
требуемую информацию и щелкните
мышью на кнопке Next.
6. Теперь нужно определить Setup Type
(тип установки) — это единственное
место, где можно изменять
местоположение файлов. Как и для
полномасштабного продукта SQL
Server, в данный момент можно
разместить свои данные на диске,
4. Теперь мастер выводит экран,
представленный на рисунке слева.
На этом экране содержится
предостережение о необходимости
завершить все другие приложения,
а также информация, касающаяся
охраны прав. Щелкните мышью .
на кнопке Next.
852 Приложение В
отличном от того, на котором
располагаются программные файлы
(см. рис. слева). Щелкните мышью
на кнопке Next.
7. Для работы MSDE необходимо
располагать информацией об используемом
по умолчанию наборе символов,
а также о некоторых других установках
по используемому языку программирования
(см. рис. справа). Все это не требует
пояснений. Обычно достаточно принять
значения, используемые по умолчанию.
Щелкните мышью на кнопке Next.
ШШШ-' г..
• ' • -
?В»т«у Order
|C£*ta
ияиннми
p
8. MSDE предоставляет возможность инсталлировать
несколько библиотек для установления
сетевых соединений (см. рис. слева).
В самом простом случае воспользуйтесь
значением, предлагаемым по умолчанию,
которое предполагает инсталляцию
только TCP/IP Sockets и Multi-Protocol.
Щелкните мышью на кнопке Next.
9. Далее мастер потребует информацию
о том, какой способ управления
учетными записями ему следует
использовать (см. рис. справа).
В самом простом случае следует
выбрать 'Use the same account for
each service' (использование одной
и той же учетной записи для всех
служб) и 'use local system account'
(использование учетной записи
локальной системы).
Инсталляция MSDE 853
dkNext U? begirt &шп$ fcifi?
10. В этот момент мастер выведет экран
для запуска процедуры копирования
(см. рим. слева); щелкните мышью
на кнопке Next.
11. После этого увидите окно с сообщением,
которое информирует о том, какие
именно файлы копируются.
Далее выводятся последовательные
сообщения по мере развития процесса.
12. Мастер выводит экран 'setup complete1
(начальная установка завершена)
(см. след. ниже рис.). Щелкните мышью
на кнопке Finish.
13. Теперь можно запустить MSDE,
выбрав пункт меню
Start | programs | MSDE | Service Manager
Service Manager для MSDE ничем
не отличается от Service Manager
для полного продукта SQL Server.
14. При желании можете указать режим
автозапуска.
Для работы MSDE требуется
приблизительно 5,3 Мбайт
оперативной памяти, а для Service
Manager — еще 2,3. Поэтому установка
режима автозапуска приведет
к захвату соответствующих ресурсов,
\ ' " •
Ике*
1
s S i P f
1
• • • • • • • ' • • • : = • ' • •
.' L
Server Service М<*.„
ft) JJ ^ -
—
-
i 1:47 PM
нежелательно, если вы
на самом деле не собираетесь
использовать систему.
Вы всегда при необходимости
можете запустить ее вручную.
15. Для запуска службы MSDE
щелкните мышью на кнопке
Start с зеленой стрелкой.
В процессе работы Service Manager
с правой стороны системной линейки,
расположенной внизу экрана, будет на-
ходиться вспомогательная иконка. Пока
MSDE выполняется, она выводится с
зеленой стрелкой, а после остановки —
с красным квадратом, как показано на
рисунке слева.
854 Пр сложение В
I
Чтобы проверить номер используемой вер-
сии, можное щелкнуть правой кнопкой мыши
на вспомогательной иконке MSDE и выбрать
пункт меню About (О программе). Вы должны
получить сообщение о том, что используете
SQL Service Manager версии 7 (см. рис. слева).
Импорт Northwind в MSDE
MSDE инсталлируется без каких-либо
стандартных баз данных, поэтому требуется
импортировать базу данных, чтобъг работать
с примерами, приведенными в главах 18 и 19.
MSDE и SQL Server поставляются совместно
с утилитой, предназначенной для импорта
и экспорта данных. Мы воспользуемся предо-
ставляемыми ею возможностями для импорта в MSDE повсеместно распростра-
ненной базы данных Northwind (nwind.mdb), КОТОрая ВХОДИТ В КОМПЛСКТ ПОСТавКИ
Access и Visual Basic 6.
Определите местоположение
БД Northwind, воспользовавшись
пунктом меню Start | Search | Files
and folders | File и набрав текст
nwind.mdb в окне Named:.
Скопируйте (но не переносите)
этот файл в папку с именем
С:\BegCSharp\AppendixB
(которую вам придется
создать самостоятельно).
2. Перейдите в раздел меню
Start/programs/MSDE or SQL
Server/Import and Export Data.
Перед вами возникнет экран,
представленный на рисунке справа,
Data Transformation Services
import/Export Wizard
TWb wuafd gudee you В I I ;-• б e steps ?o p
d l a between many popular s. spteadffoai*. < d ffe
Help
Choose о Data Source
в do you v^ant to^ c^Opy d^s? You from
D#3 Su»C'j k'-\ r' ': sift Access
^S^- *o connect select с dclab we end psovide a user name -2
1 ^ 4 ? Vcu ftvv need ^o specify edvenced opj.bnt,
p P S r p ^ l i l l l
z J
Aclvonc-cd., j
Data Transformation Wizard
(мастер трансформации данных).
3. Щелкните мышью на кнопке Next,
чтобы перейти к экрану Source
(источник), и выберите в качестве
значения поля Data Source (источник
данных) Microsoft Access, как
показано на рисунке слева, и задайте
значение в поле File name (имя
файла) — nwind.mdb (необходимо
СОСЛаТЬСЯ на КОПИЮ Northwind,
которую вы создали в директории
С: \BegCSharp\AppendixB).
Инсталляция MSDE 855
4. Щелкните мышью на кнопке Next,
чтобы перейти к экрану Destination
(назначение) (см. рис. справа)
и выбрать для поля Destination
значение Microsoft OLE DB Provider
for SQL Server (провайдер OLE DB
для SQL Server компании Microsoft),
для поля Server — значение (local),
а для Username (имя пользователя)
в разделе SQL Server Authentication
(аутентификация SQL Server) —
значение sa (пароля не требуется).
Create Datable
Specify thte name md properties of \Ы SQL j
Server database.' v - - * * I
Name:
Data file si:
Log file siz*
JNorlhwind
±J
«icel Help
в этом диалоге следует ввести имя базы дан-
ных (мы будем использовать в качестве име-
ни "Northwind") и задать размер файла Data,
равным 4 Мбайт, а файла Log — 1 Мбайт.
5. Для перехода на экран Method (метод)
(см. рис. справа) щелкните мышью
на кнопке Next и выберите copy table
(копировать таблицу). Щелкните на
Save, schedule, and replicate package
Specify iym 4Vdnl to save \Ш OTS ftfrffritflt You Мф a&o sepicste Ш& 4&1& &•
«chedufe tit psekags to be екесмЫ & з Ш* t^ne.
г When
c*e;e|y Г* и
e DTS рйс'иадв k
Choose a destination
T & <Мше do уац v;CL S^
~. То co^ntc? to ll^oxiit SOL ic«ver. j*ou л
<* U»SQLS«v«Awthen»icfiSoo[
Rehe*h [ Advanced.. | '
Перед тем как щелкнуть мышью на кнопке Next,
выберите для базы данных значение зволит перейти в показанный на рисунке слева диа-
лог Create Database (диалог создания базы данных);
Specify TdbJc Copy or
Specily л;-;! -.ы :а сору ше or tmci
h dMt source.
ij«ciry Uve 4i'.s
* F
•д(
J
кнопке Next, а затем на следующем
раскрывшемся экране выберите
copy all (копировать все).
6. Щелкните мышью на кнопке Next
и выберите режим Run immediately
(немедленный запуск), как показано
на рисунке слева.
856 Приложение В
Completing the DTS Import/Export
Wizard
You have successfully specified the information requited io
copy, if arafoi«v or Um$t& the dake* R evtew the selections
bebw жд cfck on FINISH to етеойе
Summewy:
T ]
Uong Microsoft Je? 4.0 OLE DB Provider H
Detfkvatim: Mbiosoft SQL S&tvej
Using Microso-Jt OLE: DB Piovide for SQL Server
с Back
Щелкните мышью на кнопке Next
еще раз, взгляните на окончательный
результат (см. рис. слева) и щелкни-
те мышью на кнопке Finish.
7. Доводитесь появления
сообщения об успешном
завершении, а затем щелкните
на кнопке Done (сделано).
8. Обратите внимание на то,
что все запросы, ответы
и прочая информация
копированию не подлежат.
9. Откройте Windows Explorer
и убедитесь, что в директории
C:\MSSQL7\Data теперь
наХОДИТСЯ файл N(а не .mdb).

Задание переменной среды PATH

basic — Wed, 10 Feb 2010 22:02:10 GMT

Задание переменной среды PATH
Для того чтобы иметь возможность использовать компилятор С# и другой ин-
струментарий .NET из командной строки Windows, необходимо убедиться в том,
что переменная среды PATH соответствующим образом изменена. В командной
строке поиск файлов осуществляется в рамках текущей директории; если же воз-
никает необходимость запустить файл из какой-либо другой директории, то для
этого требуется задать информацию, где именно Windows следует искать требуе-
мый файл. Это может быть сделано с помощью переменной среды PATH. В ней со-
держится список имен директорий, разделенных точкой с запятой, где Windows
будет осуществлять поиск запрашиваемого файла, если его не удается обнаружить
в текущей директории. Необходимо добавить в эту переменную информацию о двух
папках, для того чтобы система Windows могла отыскать все инструменты .NET;
ОДНа ИЗ Н И Х — ЭТО C:\Program Files\Microsoft.Net\FrameworkSDK\Bin, В которой
находится часть инструментов .NET, используемых из командной строки, такие на-
пример, как ildasm, gacutil И sn; а вторая — ЭТО папка C:\WINNT\Microsoft.Net\
Framework\vi.0.2914 (цифры в имени последней поддиректории могут варьиро-
ваться в зависимости от того, какая конкретно версия .NET Framework инсталли-
рована на вашей машине), именно в ней расположен собственно компилятор С#
(esc), а также библиотека классов system.
~— -
• Genefti.i N«Nwwfci; ; : . . ••.•;. •
£ r « « - « r r ^ V & A f c ! t j - --••
Windows 2000/XP
Чтобы задать переменную PATH на компьютере, работающем
под Windows 2000 или ХР, откройте окно System в Control
Panel и щелкните на вкладке Advanced (см. рис. слева).
f ^ ^ ^ f f i - ' 1 JJ-Si
Перейдите на вкладку Advanced, щелкните мышью на
кнопке Environment Variables... и прокрутите окно со списком
System variables до переменной Path (см. рис. справа).
f'= ГИ2ХТ
PRQCE5SORJO.>,
COM -
' -,.,;>
At.;.i> O;,VSS;.V
?, uenu-:... j*J
848 Приложение А
tdit System Variable
Variable Wamei
Variable Value:
Path
I ram Ftbs\Microsoft.Net\FrameworkSDK\Bin
OK Cancel
Выберите ее и щелкните мышью на
кнопке Edit..., которая расположена под
окном со списком.
Введите в окно Variable Value пол-
ный путь к директориям, которые вы
хотите добавить в конец списка дирек-
торий, хранящегося в переменной сре-
ды PATH, как показано на рисунке слева.
Переменная PATH представляет собой
разделенный точками с запятой список,
поэтому требуется включить одну точку с запятой перед названием первого пути,
а вторую — между названиями двух путей. Например, для современной версии
.NET Framework требуется добавить к концу строки следующий текст:
;C:\Program Files\Microsoft.Net\FrameworkSDK\Bin;C:\WINNT\
Microsoft.Net\Framework\vl.0.2914
Чтобы закрыть диалог Edit System Variable, щелкните мышью на кнопке OK,
а затем щелкните еще два раза для закрытия диалогов Environment Variables
и System Properties. После этого изменения будут сохранены в переменной PATH.
Если вы ранее открыли окно командной строки, то придется закрыть и открыть его
заново, поскольку новое значение недоступно для уже существующих окон.
W i n d o w s NT
В задании значения переменных среды под Windows NT4
существует несколько незначительных отличий. Откройте
диалоговое окно System из Control Panel точно так же,
как в Windows 2000, а затем щелкните мышью на вкладке
Environment (см. рис. справа).
Выберите переменную Path из окна со списком System
Variables. Текущее значение этой переменной появится
в окне со списком Value; добавьте необходимые для .NET
Framework значения пути в конец записи точно так же,
как и для Windows 2000 (также разделенные точкой с за-
пятой). Щелкните мышью на кнопке Set для обновления
имеющегося значения, а для его сохранения — на кнопке
ОК. Теперь новое значение будет доступно для всех вновь
открываемых окон.
OS
1 PA*hiA7
IMP
1 и
.;. •;:•;.•*•.•:•?
шшааетв-1
jd
_jg_j _gi^J
Owed j ;' •=:.; 1
Windows 95/98/ME
Если вы используете Windows 9x или Windows ME, то, чтобы изменить значе-
ние переменной PATH, требуется модифицировать текстовый файл autoexec.bat.
Этот файл содержит информацию, используемую для конфигурирования Windows
в момент ее запуска, и располагается в корневой директории жесткого диска
(например, C:\autoexec.bat). Откройте файл в редакторе Notepad или любом дру-
гом текстовом редакторе и добавьте следующую строку:
SET РАТН=%РАТН%;С:\Windows\Microsoft.NET\Framework\vl.0.2914
Задание переменной среды PATH __ 849
В данном случае нужно привести значение пути в соответствие с используемой
системой и версией .NET Framework. Введенный путь будет добавлен к существу-
ющей переменной PATH. Обратите внимание на то, что на машинах, работающих
под управлением Windows 9x или Windows ME, будут инсталлированы не все инст-
рументы .NET Framework. В завершение необходимо перезапустить Windows —
только после этого сделанные изменения вступят в силу.

Создание подписной формы для пользователя

basic — Wed, 10 Feb 2010 22:01:35 GMT

Создание подписной формы для пользователя
Все страницы, предназначенные для управления списками рассылки и подпис-
чиками, отправки сообщений по электронной почте изменения внешнего представ-
ления, завершены. Осталось создать подписную форму, которая позволит
конечному пользователю подписаться на некоторый список.
Вместо создания одной подписной формы,
создадим страницу ASP.NET (см. рис. слева),
которая будет автоматически генерировать
HTML-форму для заданного списка рассылки.
Администратор сначала выбирает список
рассылки, для которого он собирается созда-
вать подписную форму, потом определяет не-
обходимость наличия полей для первого
и последнего имени (эти поля при подписке
не являются обязательными, поэтому форма
вполне может без них обойтись). Создавае-
мая форма будет иметь две кнопки, которые
реализуют две возможности пользователя —
подписаться и отказаться от подписки. При
нажатии кнопки Create генерируется HTML-
код, который помещается в расположенное
в нижней части страницы текстовое окно,
а сама форма выводится в центре страницы
для предварительного просмотра. В этот мо-
мент у администратора есть возможность
скопировать сгенерированный HTML и пере-
нести его в произвольную страницу.
• - . ' • ' . .
Практический пример 2 — Менеджер рассылки новостей в режиме онлайн 837
Страница FormWizard.aspx
Первая часть страницы, в которой находятся раскрывающийся список и тексто-
вые окна, строится как обычно, с выравниванием всех управляющих элементов
при помощи таблицы. Вторая часть таблицы, которая располагается на приведен-
ном выше рисунке за надписью "Result Form:"(полученная форма), по умолчанию
является невидимой и выводится, только когда пользователь нажимает кнопку
Create. Поскольку код этой страницы почти целиком состоит из управляющих эле-
ментов ASP.NET, с аналогами которых мы уже встречались ранее, этот код здесь
не приводится.
Код поддержки для страницы FormWizard.aspx
Код поддержки для этой страницы производит обращение к базе данных для
заполнения раскрывающегося списка имеющимися в наличии списками рассылки,
а также извлекает URL страницы Subscribers.aspx из таблицы settings. Осталь-
ная часть программы занимается созданием HTML-текста для формы с учетом
выбранных опций. Обработчик событий create_ciick() создает HTML-строку,
содержимое которой определяется в зависимости от опций, выбранных админист-
ратором в верхней части формы. Поскольку в этом коде не содержится чего-либо
нового или интересного, мы этот код воспроизводить не будем.
HTML-КОД, СОЗДанНЫЙ Обработчиком событий Create_Click() , ВЫВОДИТСЯ
в управляющем элементе Label с именем ResuitForm, что позволяет пользователю
осуществлять предварительный просмотр результатов своей работы. Получаемый
HTML не является законченным, поскольку в качестве корне-
вого элемента в нем присутствует тег димости его можно легко скопировать из текстового окна
в отдельный файл.
На рисунке слева можно увидеть некоторые тестовые фор-
мы, сгенерированные с использованием данной страницы.
Первая из представленных выше форм, была создана без ис-
пользования всех трех возможных опций, вторая — с исполь-
зованием двух первых опций (запрос первого и последнего
имени), а третья форма создавалась с использованием всех
трех имеющихся возможностей.
Совершенно очевидно, что, поскольку создаваемый код
представляет собой обычный HTML, есть возможность видо-
изменять получаемый результат по своему усмотрению: на-
пример, изменить цвет, шрифт, ширину текстовых окон,
использовать определенный рисунок для границ или фона или
вывести комментарии, позволяющие пользователю получить
дополнительную информацию относительно списка, на кото-
рый он подписывается. Очень полезным представляется ис-
пользование функции на JavaScript, которая позволяет перед
фактической отправкой формы убедиться в том, что поле, со-
держащее адрес электронной почты, не является пустым.
Подписка на список рассылки
До этого момента мы смотрели на приложение с точки зрения администратора,
а как быть с конечным пользователем? Посетитель зашел на наш web-сайт и ре-
шил подписаться на какой-либо список рассылки, но каким образом он может это
: . Pi* Zi\ V«w Fev«£e» Tcr« н?'р
i
^ «.
Subfnjt j
MufCQ ^ . Д
J
838 Практический пример
осуществить? Именно это мы сейчас и продемонстрируем. Страница с подписной
формой может находится где угодно, даже на другом сервере, поскольку она ука-
зывает на ПОЛНЫЙ URL Страницы Subscribe.aspx.
Настала пора протестировать одну из подписных форм, представленных на
странице, которая изображена на предшествующем рисунке и которая позволяет
регистрировать новых подписчиков. Мы будем заполнять третью из форм, пока-
занных на рисунке. Если на странице администратора выбрана установка Send
Subscription Email (отправить сообщение о подписке), что происходит по умолча-
нию, если вы используете включенный в состав программного обеспечения файл
с установками, то подписчик получит по электронной почте сообщение с подтвер-
ждением, содержащее информацию, заданную им самим:
& Welcome to the тсЖпг* list €#
ь
Reply . Reply All Forward Юг* Delete Previous
from: NewsMallcr Team
Date: Sunday, ЛиЕу 15, 2001 7:52 PM
To; mbelllna$o#vb2themcis.com
Добро пожаловать в список рассылки С#, дорогой Марко Бе/шииазо*
ДЛЯ отказа от подписки щелкните мышью на следующей ссылке:
••g-.com
1 1 1 я
Последняя строка этого сообщения представляет собой ссылку, которая, в слу-
чае если ее нажать, удалит данного подписчика из списка рассылки. Эта ссылка
создается динамически из приведенной ниже строки посредством замены тегов на
соответствующие значения, извлеченные из XML-файла:
#SubscriberURL#?ListID=#ListID#&Action=Unsubscribe&Email=#SubscriberEmaiI#
Параметр Action отличает подписку от отказа от подписки. В данном случае
ему присваивается значение unsubscribe. Ссылка ддя осуществления подписки
представляет собой точно такую же строку, но не содержащую параметра Action,
или содержащую параметр Action, которому в качестве значения присваивается
произвольная строка (только не unsubscribe). Остальные параметры, входящие
в ссылку,— это идентификатор списка рассылки (который хранится в форме
в скрытом поле) и адрес электронной почты подписчика.
Сообщение о подтверждении посылается по электронной почте, только если есть
соответствующая установка. Вы, однако, всегда будете получать web-страницу
с подтверждением, в которой содержится тот же самый текст, что и в сообщении.
Процедура отказа от подписки аналогична: администратор определяет, должно ли
посылаться подтверждение, но на сайте в любом случае выводится соответствую-
щая web-страница. Чтобы протестировать выполнение этой операции, откройте
ссылку, присутствующую в предыдущем сообщении, это приведет к открытию бра-
узера и выводу сообщения, представленного на рисунке на стр. 839.
Вы получите точно такой же результат, если выберете опцию unsubscribe
(отказ от подписки) в HTML-форме. У администратора есть также возможность
добавлять или удалять подписчика с помощью страницы subscribers.aspx.
Практический пример 2 — Менеджер рассылки новостей в режиме онлайн 839
NewsMatter; Subscription - Microsoft Internet Explorer
•As
.a^px?listiD«38^cbcf^Unsub$ab^£md^
До свидания» С#
8ы исключены из списка рассылки С#. Почему вы приняли такое решение???
~гг
Страница Subscribe.aspx
Код, предназначенный для создания этой страницы, является наиболее корот-
ким из всех встречавшихся нам в этой главе:
<азр:Label ID="Subject" runat-"Server" ,
CssClass="SubscrSubject:i Visible^"false" />
CssClass="SubscrMessage" Visible^"false" />
Text="The Email address is required" Cless=Error" />
На странице присутствует три надписи: для подтверждения, для тела сообще-
ния и для сообщения об ошибке, если не задан адрес электронной почты. Все эти
надписи по умолчанию являются невидимыми. Они выводятся, только после того
как пользователь выполняет операцию подписки или отказа от подписки и в соот-
ветствии с ее результатом.
Код поддержки для Subscribe.aspx
Весь код данного класса поддержки помещен в процедуру Page_Load(), поско-
льку все операции выполняются в момент загрузки страницы и на ней не сущест-
вует каких-либо форм или управляющих элементов, которые приводят
к наступлению других событий. Код для данного обработчика событий приводится
ниже полностью:
protected void Page__Load(object sender,EventArgs e)
.; :•.:;.• , • i n t S u b s c r l D ; .-. . . . : .. ..• . • • :
bool SendEmail;
// считать ListID, FirstName, LastName, Email and Action
//из QueryString, сгенерированной формой HTML
int ListID = int.Parse(Request.Params["ListID*]); ;
string FirstName = Request .Params [* FirstName•] + ' " ;
string LastName = Request.Params[^LastName"] + " "] ;
string Email = Request.Parains ['Email'] + * '] ; ::
string Action = Request.Params["Action"] + • *;
if (Email.Trim()=-"")
// если объект Email не был определен,
// вывести сообщение об ошибке и завершить работу
EmailRequired.Visible = true;
e l s e : " .' • • ' :••" •• •••••••:'-';: • : • • • '••• : ' ' '
{ . '• • ^ . Щ : Ш$Щ
string SubjectText;
string MessageText; . : " ;
840 Практический пример
// создать объекты для работы с установками и с подписчиком
NewsMailer.AppSettings settings =
. NewsMailer«AppConfig.GetSettings{
. , Server.MapPath{GetSettingsFile()});
NewsMailer.SubscribersDB subscribers - new
NewsMailer.SubscribersDB(GetConnString());
// лишение подписки
if (Action.CompareTo ("Unsubscribe" }—0) ;
{
// считать сообщение от подписчика
//и проверить, требуется ли подтверждающий ответ по Email
SendEmail - settings.SendUnSubscrSmail;
SubjectText = settings.UnsubscrSubjееt;
MessageText = settings.UnSubscrMessage;
// считать ID этого подписчика из Email
SubccrlD - subscribers.GetSubscrID(ListID/ Email);
// заменить теги этого подписчика
MessageText = NewsMailer,Utilities.ProcessSubscriberTags(
MessageText, GetConnString(), SubscrlD);
. ••// вычеркнуть подписчика :
subscribers.Delete{SubscrlD); •
} :, •
else //оформить подписку
{ ' • •;..;.;.
• ' // считать сообщение от подписчика
// и проверить, требуется ли подтверждающий ответ по Email
SendEmail = settings.SendSubscrEmail;
SubjectText = settings.SubscrSubject;
MessageText. = settings. SubscrMessage;
••;: // добавить подписчика
subscribers.Add(ListID, FirstName, LastName, Email);
// получить ID только что зарегистрированного подписчика
// или, если подписчик уже зарегистрирован
// с известным Email адресом
SubscrlD - subscribers.GetSubscrlD(ListID, Email);
//заменить теги нового подписчика
MessageText = NewsMailer.Utilities.ProcessSubscriberTags(
MessageText, GetConnString(), SubscrlD);
::-:::> } .. .Л--
// заменить теги по установке и в списке
SubjectText = NewsMailer.Utilities.ProcessListTags(
SubjectText, GetConnString(), ListID);
MessageText = NewsMailer.Utilities,ProcessListTags(
MessageText, GetConnString(), ListID);
MessageText = NewsMailer.Utilities.ProcessSettingsTags (
MessageText, GetConnString());
// если требуется подтверждающий ответ
••:•: : if (SendEmail)
{ ':: .
// создание нового сообщения
MailMessage MailMsg = new MailMessageO ;
MailMsg.From = settings .SenderName + • <" +
; Settings -.Sender Email + ">";
// заполнение поля "Кому" в Email
M a i l M s g . Т о = E m a i l ; .:••••••..•.,•:... ..:..,•••• •••...-.... •.,.,,:.:::; •,•;.,,:; . x , - . • ,..,: .,
// заполнение поля "Содержание",
//созданного для случая подтверждения
MailMsg.Subject -SubjectText;
MailMsg.Body = MessageText;
Практический пример 2 — Менеджер рассылки новостей в режиме онлайн 841
/7 отсылка сообщения
S m t p M a i l . S e n d ( M a i l M s g ) ; . • -.
v-:• ) S : : : ; Ж , :•; •;• •I)'ЖЙ•' •?• ^ :>:• ••;...:;.'';;:U>'/% J \ ш • '^МЖ^^ •• ••/•:• *ШШ^• • • ':• Ш"'' • • •'• V. -: • . - •.". :,
// вывод сообщения, подтверждающего выполненное действие
•;•;••::•••••., . Subject.Text = SubjectText;
Message.Text - Message-Text;
Subject .Visible = true; . . . • :. ' •
Message,Visible = true;
) • • ; • • • ' • Ш
В первых строках кода из строки запроса извлекаются идентификатор требуе-
мого списка, имя подписчика и его адрес и переносятся в локальные переменные,
с тем чтобы их было проще использовать в данной процедуре в дальнейшем.
Прежде, чем переходить к выполнению дальнейших операций, программа выпол-
няет проверку, не является ли параметр с адресом электронной почты пустым,
и если является, то на экран выводится надпись об ошибке EmaiiRequired (адрес
электронной почты необходим), а остальная часть процедуры не выполняется.
Если адрес электронной почты присутствует, а параметр Action имеет значение
unsubscribe, то программа сначала задает предмет сообщения и текст подтверж-
дения и заменяет специальные теги на информацию о конкретном подписчике,
а затем удаляет информацию о данном подписчике из базы данных. В противном
случае информация о подписчике сначала добавляется в базу данных, а затем
происходит замена тегов. Замена тегов осуществляется после, поскольку методу
utilities.ProcessSubscriberTagsо требуется передать в качестве параметра
идентификатор подписчика, следовательно, информация о новом подписчике сна-
чала должна быть занесена в БД. После этого производится замена специальных
тегов, касающихся списка рассылки и установок, которая является необходимой
независимо от того, подписывается ли пользователь или производит отказ от под-
писки. Если в файле установок хранится информация о том, что требуется отпра-
вить по электронной почте сообщение с подтверждением (состоящее из предмета
сообщения и тела сообщения), то процедура отправляет такое сообщение.
Обеспечение безопасности приложения
К настоящему моменту мы полностью реализовали функциональные возможно-
сти приложения: произведено тестирование программы как со стороны админист-
ратора, так и со стороны конечного пользователя — все работает замечательно.
Осталось обеспечить безопасность. Если не предусмотреть какой-либо либо про-
цедуры регистрации, управляющей доступом к страницам администратора, то это
приведет к тому, что каждый пользователь сможет проникнуть туда и получить
информацию об адресах электронной почты подписчиков, послать фиктивные со-
общения по электронной почте, уничтожить списки рассылки и т. д. При создании
любого общедоступного web-приложения обеспечение безопасности должно быть
одной из самых первых вещей, которые принимаются во внимание на стадии раз-
работки. Однако для небольших приложений, подобных создаваемому нами, обес-
печение безопасности и аутентификация пользователей может быть реализована
в качестве завершающего этапа разработки — без каких-либо проблем и с потря-
сающей легкостью.
842 Практический пример
Установки для обеспечения безопасности
в файле web.config
Впервые мы столкнулись с файлом web.config, когда обсуждали вопрос о хра-
нении строки соединения. Этот файл конфигурации может быть использован так-
же для хранения установок web-страниц, управления состоянием сеанса, приложения
(как например, включенных нами строк connstring и settingsFile), трассировки,
компиляции, обеспечения безопасности и для многого другого. Этот файл оказы-
вается очень полезным, поскольку он позволяет переопределять установки IIS.
Мы планируем рассмотреть хранящиеся в этом файле установки для обеспечения
безопасности. ASP.NET. Названный файл установок предоставляет простой спо-
соб реализовать гибкую систему аутентификации пользователей (в результате чего
пользователю будет либо разрешен, либо запрещен доступ к сайту) и систему
определения полномочий (которая либо предоставляет какие-либо права, либо
отбирает их у пользователей). Основная часть работы выполняется в следующих
строках программы:
: v protection=nAllB timeout="60">
' . • •• • • : • •• < / c r e d e n t i a l s > •:. : • . .: ,. - . •• ' ; • ;• Щ
• ,. ' ' ' ••-.:•. •:•.:•:••/. : ' .:•..•. •/• < / a U t h o r i Z a t i o n > . • • •• " ••.••.: • ' ': •• • : • \. : ../:':'.. .'••'. . • .-:'.::
Data source=E:\Projects\NewsMailer\DB\NewsMailer.mdb" />
• Выполнение аутентификации в режиме Forms означает, что для регистрации
будет использоваться web-форма (в качестве альтернативных вариантов можно
указать систему HTTP Basic или систему Microsoft Passport). Строки программы,
расположенные внутри раздела гистрации, на которую пользователи будут отправляться, если они не пройдут про-
цедуру аутентификации при попытке доступа к закрытым страницам. Для хранения
информации о регистрации и о полномочиях пользователей, которым разрешен
доступ к сайту, используется куки (.NEWSMAILER). ДЛЯ нашего простого примера
мы храним полномочия в виде комбинаций имени пользователя — пароля. В за-
вершение тег определяет, что анонимным пользователям запрещается входить в закрытую часть
приложения.
Обеспечение безопасности в ASP.NET может быть намного более сложным
и профессиональным — это всего лишь пример основ системы аутентификации
пользователей и определения полномочий. Если вы собираетесь пользоваться
файлом web.config, то у вас также появляется возможность зашифровывать
Практический пример 2 — Менеджер рассылки новостей в режиме онлайн 843
пароли с помощью Triple DES. Другая возможность заключается в том, чтобы
либо хранить имена пользователей и пароли в таблице базы данных и использо-
вать собственную функцию для проверки правильности регистрационной информа-
ции, переданной пользователем, либо проверять пользователей по Windows Active
Directory. Все это, однако, выходит за рамки настоящего раздела. Более подроб-
ную информацию вы сможете почерпнуть в документации .NET Framework SDK
или в книге "ASP.NET для профессионалов" ("Professional ASP.NET"), выходящей
в издательстве "Лори" в 2004 г.
Файл Login.aspx и его код поддержки
Теперь нам необходимо создать
Страницу Login.aspx, КОТОрая
в законченном виде выглядит так,
как показано на рисунке справа.
Код, необходимый для создания
страницы, не представляет из себя
ничего особенного — для других
страниц нам уже приходилось пи-
сать более сложные программы,
поэтому сразу перейдем непосред-
ственно к коду, ответственному за
обработку нажатия кнопки Login:
ЭкетМ*
******* T——
> ~ i , ' ',,, '•- ' г '%'., ."( < • , 'I-V ,н • >>г' ,', J ; ¥<-,<
L o g i n P a y t ' j
I- ц и ti- JM «;И.
& Po;'5is*'?nt Login
protected void LoginUser_Click (object sender, EventArgs e)
{
//проверка имени и пароля данного пользователя
if (FormatAuthentication.Authenticate(UserName.Text, Password
. : { ' ' •• : • . • • • . • •' •. •. .. • • • - • ' • •:'• ' • • . • • , • : • • • • . . • , :
// если пользователь аутентифицирован, разрешить вход
// (если если это требует пользователь) перейти на страницу,
// которую требует процедура аутентификации
FormsAuthentication, RedirectFromLoginPage(UserName.Text,
Persistent.Checked);
els
•••/./• если имя пользователя или пароль неверны, вывести сообщение об ошибке
I n v a l i d L o g i n . V i s i b l e - t r u e ; •.;:,.••••--'':''••:-:'.,•; •' :•-•'; •.•:':::..'.••,-. • : ; • • ; • ••:-::;-- •;,..• • : ;.•••.
В этой программе осуществляется вызов метода AuthenticateO, который про-
изводит проверку правильности имени пользователя и пароля. Если они не распо-
знаны, то выводится надпись InvalidLogin, в противном случае, регистрационная
информация записывается в куки (если в окне выбора Persistent Login установлен
соответствующий флажок), и браузер переходит на страницу, которая необходима
для регистрации пользователя. URL этой страницы передается в строке запроса,
и вы можете увидеть ее в линейке с адресом на рисунке, приведенном выше: там
ВЫВОДИТСЯ URL localhost/newsmailer/Lis-ts.aspx В закодированном виде. В ЭТОМ
случае, если пользователь попытается загрузить некоторую страницу и не пройдет
процедуру аутентификации, то он будет снова отправлен на страницу регистрации
и после успешного прохождения аутентификации возвращен на исходную страницу.
Теперь приложение выглядит вполне завершенным, однако остается еще одна
маленькая проблема. Что произойдет, если пользователь отправит форму, для того
844 Практический пример
чтобы подписаться на некий список? Такой пользователь не будет аутентифициро-
ван, поэтому он будет отправлен на страницу регистрации. Такого, естественно,
быть не должно, и одним из возможных решений этой проблемы является перенос
страницы Subscribe.aspx в другую папку, куда анонимный пользователь будет*
иметь возможность загрузить требуемую страницу. Такой способ будет, конечно,
работать, но здесь потребуется предусмотреть два файла web.config: один со стро-
кой соединения, хранящийся в корневой папке, а второй с установками для обес-
печения безопасности, хранящийся в закрытой папке. Существует, однако, более
простое решение, для реализации которого требуется добавить лишь несколько
строк в уже существующий файл web.config, и это позволит оставить страницу
Subscribe.aspx там же, где находятся все остальные. Мы располагаем возмож-
ностью задавать различные опции для обеспечения безопасности разных файлов
с помощью тега делали это раньше, а затем открыть анонимным пользователям доступ только
К странице Subscribe.aspx:
...Code omitted for clarity
• • : •: -. ' :. ••••••.•••• - • • • • ' ' •• ' < a l l O W U S e r S = " * " / > '• . •••••.••••••, : •• . , . • • • : ; • • • , • . • • ' , •••• : .•;•••••,:• > v •
• • ;••••..,-,•, • • • • < / s y s t e m . w e b > ..•••.• . • •• • • • • • . . • • • . . .••, :. • . ,•. :, ••••:•••.•:•:• .
Теперь при отправке пользователем формы и загрузке страницы Subscribe.aspx
ASP.NET распознает пользователей как анонимных и разрешает им доступ к этой
странице. Если же пользователь осуществляет попытку попасть на любую другую
страницу (возможно, узнав правильный URL этой страницы), то у него будет за-
прошена регистрационная информация.
И еще один момент: что необходимо предпринять, если возникает необходи-
мость выйти из системы и уничтожить куки, в которых хранится регистрационная
Информация? Мы ВОСПОЛЬЗуеМСЯ метОДОМ SignOutO объекта FormsAuthentication
(который находится в пространстве имен System.web.security) — он выполняет
именно те действия, которые нам требуются. Названный метод вызывается в про-
цедуре Page_Load(), если в строке запроса параметру Action присваивается значе-
ние "logout":
protected void Page_Load(object sender, EventArgs e)
{
// если строка QueryString имеет выходной параметр, осуществите выход
//и удалите куки для входной страницы •
if {Request.Params["Action"]=="logout")
FormsAuthentication.SignOut (); : J:
Практический пример 2 — Менеджер рассылки новостей в режиме онлайн 845
РЯЯЯ?Ш?82<»№&*; гh -••• -•.
j Ш $ii References
! .— *-Й Asse#ib{yln*o.c$
- «Э BasePage.cs
^ j— ||] Forfn¥sflzard.aspx
U Header.ascx
{ Д] Lists^spx
I | h В NeweHttory^jpX
K E S ?
I I f* H Subitrsbe.aspx
Г! г* S Subsorsbers.aspx
| - • [Й Web.conf»g
fj ;*?'" М|Л<ГйД|
: • • i
1
\
\
Страница с таким значением параметра вызывается посредством пункта меню
Logout, который описан в пользовательском управляющем элементе Header следу-
ющим образом:
NavigateUrl="Login.aspx?ReturnUrl=Lists.aspx&Action=logout
Text="Logout" Class="MenuItemi; .../>
Обратите внимание на то, что в этом случае, кроме параметра *Action=iogout"
используется также и параметр Retumuri, имеющий значение Lists.aspx. Это
оказывается необходимым, поскольку после выхода из системы мы возвращаемся
обратно к регистрационной форме. Если администратор сразу повторно зарегист-
рируется, то странице регистрации необходимо иметь информацию о том, на какую
страницу необходимо перейти.
Компиляция модуля
Последним шагом, перед тем как приступим к тестированию
приложения и загрузке его на web-сервер, является компиляция
всех файлов с кодом поддержки, созданных до настоящего момен-
та. Если вы используете VS.NET, то ваш Solution Explorer должен
выглядеть так, как показано на рисунке слева.
Выберите, команду Build, и VS.NET откомпилирует ваш проект,
ПОЗабоТИВШИСЬ О ССЫЛКах На Два биЗНеС-МОДулЯ (NewsMailerConf ig
И NewsMailerDB).
Запуск приложения
После того как модули откомпилированы, необходимо убедиться
в том, что они находятся в директории bin, которая, в свою очередь,
помещается в корневой папке web-приложения или виртуальной
папке, создаваемой администратором IIS. Измените строку соеди-
нения в файле web.config так, чтобы она указывала на БД Access
(или DSN), и после этого вы готовы к тестированию программы
в Internet Explorer. Чтобы попасть на страницу Lists, необходимо
Отправиться ПО адресу http://localhost/newsmailer/Lists.aspx.
Проблемы совместимости браузеров
Все страницы указанного приложения были разработаны и протестированы
в Internet Explorer 5.5. Если вы используете приложение совместно с Netscape б,
то его внешнее представление будет несколько отличаться, поскольку Netscape
интерпретирует некоторые установки таблицы стилей по-другому. При использо-
вании более ранних версий Netscape данный сайт будет выглядеть еще хуже. Это
составляет большую проблему для сайтов, которые должны быть доступны для
широкой публики. В промышленных системах, когда невозможно потребовать от
пользователей применения определенного браузера (как, например, в данном слу-
чае — по крайней мере, в отношении администраторов), представляется важным
разрабатывать web-страницы так, чтобы они могли работать на любом браузере.
846 Практический пример
Итоги
Первое приложение ASP.NET, использующее базу данных, завершено. Главной
целью этого практического примера было показать, насколько простым является
написание web-приложения, как для этого можно использовать С# и что нужно
для того, чтобы воспользоваться преимуществами, которые дает .NET Framework.
Мы узнали, что использование серверных управляющих элементов ASP.NET по-
зволяет запросто сэкономить на написании нескольких сотен строк кода, получив
при этом более стройный и приятный результат.
Настоящее приложение может использоваться прямо в таком виде для множе-
ства web-сайтов, однако можно включить в него дополнительные возможности,
чтобы сделать его еще более мощным! Предлагаем вам несколько идей:
• Предусмотрите возможность создавать и работать
с подписными формами, которые позволяют пользователю
подписываться за один прием сразу на несколько списков рассылки,
сообщив свой адрес электронной почты только один раз.
• Предусмотрите возможность, позволяющую пользователю выбирать,
хочет ли он получать новостные сообщения в виде HTML или
обычного текста, и отправлять различные сообщения
в соответствии с этим выбором.
• Предусмотрите возможность отправлять вместе с новостными
сообщениями различные приложения.
• Предусмотрите возможность работы нескольких администраторов,
каждый из которых обладает различными правами. Например,
администратор базового уровня получает возможность только
просматривать текущие списки рассылки, и информацию о подписчиках,
администратор второго уровня может отправлять новые сообщения,
а самый продвинутый администратор обладает полным набором прав,
то есть возможностью добавлять, удалять и изменять списки рассылки
и информацию о подписчиках.
Большинство тем, рассмотренных здесь, посвящены web-разработке с исполь-
зованием ASP.NET, но многие принципы и некоторый код (в частности, класс
u t i l i t i e s ) могут быть также приспособлены для использования в приложениях
Windows, например, управление вводом/выводом, объектно-ориентированная раз-
работка, доступ к БД посредством ADO.NET и многие классы .NET Framework.
Поэтому вы можете воспользоваться этим кодом, даже если web-программирова-
ние не является основным объектом ваших интересов.

Редактирование и обновление списков

basic — Wed, 10 Feb 2010 22:00:57 GMT

Редактирование и обновление списков
М ы переходим к реализации методов, которые осуществляют редактирование
и обновление списков:
protected void ListsGrid_Edit (object sender, DataGridCoiranandEventArgs e)
{
ShowAddNewControls(false);
//начать редактирование
ListsGrid.Editltemlndex = (int)e.Item.Itemlndex;
BindGridO;
•• • i i i > i ушшшшш ш •••:
:- • •' : " v ••.-•• ш
protected void ListsGrid_CancelEdit (object sender", DataGridCornmandEyentArgs
ListsGrid.Editltemlndex = -I;
. • • • • . , • • . . - . • , • . . . • . B i n d G r i d O ; •••• . • ' • ' • : • ••'••' '' : " : ; ; • : V ' \ . : , - - : • , . • • • ; . . . .. : •
: protected void ListsGrid_Update(object sender, DataGridCoiranandEventArgs e)
: : • < •'•' . •.''/. - : : ' : -
if (Page.IsValid)
{ ' Щ. •• - ; :
:
.;. //получить новые данные из диалоговых окон
string ListName = ((TextBox)e.Item.FindControl("EditListName")).Text;
string ListDescr = ((TextBox)e.Item.FindControl("EditListDescr")).Text;
int ListID = (int)ListsGrid.DataKeys[e.Item.Itemlndex]; Ш
NewsMailer.ListsDB lists = new NewsMailer.ListsDB(GetConnString()};
//обновить значения
lists.Update(ListID, ListName, ListDescr);
ListsGrid.Editltemlndex = -1; •
BindGridO;
Первая процедура ListGrid_Edit(), вызываемая при наступления события,
прячет управляющие элементы для включения новой строки и присваивает свойст-
ву Editltemlndex в качестве значения индекс редактируемой строки; это значение
извлекается из объекта item, который представляется в качестве свойства объек-
та е, передаваемого функции в качестве параметра. Наконец, опять вызывается
метод BindGridO для привязки данных текущей строки к двум текстовым окнам.
Когда нажимается иконка X, свойству Editltemlndex присваивается -1 и таблица
обновляется.
Практический пример 2 — Менеджер рассылки новостей в режиме онлайн 821
Наибольший интерес представляет то, каким образом происходит обновление
строки, осуществляемое процедурой ListGrid_update (). Выполнение кода проис-
ходит, только если страница является допустимой, т. е. когда соблюдены все пра-
вила проверки допустимости управляющих элементов. В этом случае текстовое
окно Name должно содержать допустимое имя. При успешной проверке выполнение
функции продолжается, в результате чего извлекаются текущие значения из обоих
текстовых окон. Ссылка на каждое из окон возвращается методом Findcontroi о
объекта item, после чего их содержимое считывается посредством свойства Text.
Для считывания текста из управляющего элемента TextBox необходимо текстовое
окно, которое не возвращается методом Findcontroi () в явном виде, поэтому при-
ходится вручную приводить возвращаемый объект к типу TextBox. Последний не-
обходимый параметр — это идентификатор обновляемой строки, получить который
не составляет никакого труда, поскольку данная колонка была объявлена в качест-
ве первичного ключа таблицы данных, поэтому вся работа сводится к считыванию
значения свойства. В заключение создается объект ListsDB и вызывается метод
updateO, которому передается идентификатор списка, а также новые имя и описа-
ние; в результате этого изменения вносятся в базу данных, и остается только об-
новить таблицу, чтобы эти изменения нашли в ней свое отражение.
Удаление списка
Процедура обработки события ListGrid_Deiete() обладает в точности такой же
структурой, что и только что рассмотренные события, хотя она несколько проще;
единственный параметр, который необходимо передавать методу Delete () объекта
ListsDB,— это идентификатор списка, возвращаемый перечислимым свойством
DataKey:
• protected void ListsGrid_Delete{object sender, DataGridCommandEventArgs e)
ShowAddControls(false);
ListsGrid.Editltemlndex = -1;
NewsMailer»ListsDB lists = new NewsMailer.ListsDB(GetConnString());
// получить идентификатор списка и удалить его
Lists.Delete( (int)ListsGrid.DataKeys[e.Item.Itemlndex] );
BindGridO;
} . •
Создание списка
Последнее, с чем нам осталось познакомиться,— это добавление новой строки.
При нажатии кнопки Create на экран выводятся два текстовых окна и соответству-
ющие иконки для подтверждения или отказа от выполнения операции, в то время
как сама кнопка Create становится невидимой. Кроме того, свойству таблицы дан-
ных Edititemindex присваивается значение - 1 , что предотвращает выполнение ка-
ких бы то ни было операций редактирования. Ниже приводится код для обработки
этого события, а также код функции, которая выводит или прячет управляющие
элементы в зависимости от значения передаваемого ей логического параметра:
protected void: Create_Click(object sender, EventArgs e)
{ .
// показать диалоговые окна и кнопки для добавления новой записи
ShowAddNewControls(true);
ListsGrid.Editltemlndex = -1;
BindGridO ; '
822 Практический пример
protected void ShowAddNewControls(bool ShowControls)
РШРР . • {
// показать / спрятать управляющие элементы для добавления новой записи
NewListNarne.Text^" •; ' . .
.::;•:.:•••;: NewListDescr.Text=" •; .
AddNewControlsRow.Visible = JShowControls; :
CreateNewRow.Visible=IShowControls;
PPPPi• ' •'•: '" PPPP'i-. :;"':Ф:Щ!1:;::л!:::;:'• •..';;::Р:ЙРPy-:?1^Ш1:;?.1К?Э" :лШ>::Ш
Иконка, добавляющая новый список, представляет собой не что иное, как
кнопку, для которой обработка события "щелчок мышью" имеет следующий вид:
protected void AddNew_Click(object sender, EventArgs e)
{
if (Page.IsValid)
Ш-ЙР. {
NewsMailer.ListsDB lists = new NewsMailer.ListsDB(GetConnString() );
//добавить новую запись
lists.Add(NewListName.Text, NewListDescr.Text);
. ShowAddNewControls (false) ; :: " :
BindGridO ;
Если страница является допустимой, как в случае события update о , то про-
грамма получает содержимое двух текстовых окон и передает эти строки методу
Add о объекта ListsDB. В данном случае код оказывается несколько проще, посколь-
ку можно непосредственно ссылаться на оба окна, так как других управляющих
элементов с такими именами не существует.
Иконка, отменяющая операцию добавления, представляет собой управляющий
элемент ButtonLink, который, будучи нажатым, прячет все управляющие элементы
для имени и описания нового списка и восстанавливает все в том виде, в каком это
выводилось по умолчанию. Ниже, приводится код для обработки события click:
protected void CancelAddNew_Click(object sender, EventArgs e)
Щ i '' . • ' • / : ; ; : - Й ^ р ^ Ш ^ Ш ^ ^ ^ . ^ •. •'.',,:-;-^ ••:•' '•:•/; v.:.'
ShowAddNewControls(false);
\P::Wi::^;:::)ЖР Ж v;-: ШШ'£W¥:C;W:>::-ШР?ЖiPBwP:(Ш-:кШШШР;:;P •.i.:::;: •:•:••••. :• •' •: •:: Ш
9 • •
Здесь следует обратить внимание на один очень важный момент. Нажатие
кнопки приводит к тому, что страница отправляется обратно. В этот момент произ-
водится проверка допустимости управляющих элементов с именем и описанием, и,
если имя нового списка отсутствует, отправка страницы будет прекращена. Чтобы
избавиться от этой проблемы, можно установить режим, при котором нажатие
этой кнопки не приводит к проверке допустимости формы, присвоив ее свойству
CuasesValidtion значение false.
На этом код для данной страницы завершен. Для создания страницы потребо-
валось не такое уж большое количество кода, особенно по сравнению с кодом, ко-
торый был бы необходим при использовании традиционного ASP — даже простое
создание многофункционального табличного представления данных потребовало
бы несколько сотен (если не тысяч) строк сложного кода на ASP.
Управление подписчиками
Страница для управления подписчиками списков очень похожа на только что
проанализированную страницу, поэтому в данном разделе мы остановимся только
на ее отличиях. На рисунке (см. стр. 823) страница изображена в том виде, в каком
Практический пример 2 — Менеджер рассылки новостей в уежиме
она выводится в процессе добавления
нового подписчика. Пользователь про-
извел попытку подписаться, не указав
своего адреса электронной почты, поэ-
тому программа проверки допустимости
сообщает ему, что поле Emaii должно
быть заполнено обязательно.
Страница
Subscribers, aspx
Как видно на рисунке, эта страница
отличается от предыдущей. Одно из от-
личий заключается в том, что в таблице
присутствует другое количество столб-
цов и, кроме того, имеется раскрываю-
щееся окно, в где можно осуществлять выбор списка рассылки и просматривать
подписчиков этого списка. Помимо этого есть кнопка, которая переносит пользо-
вателя на страницу, позволяющую отправить новое сообщение по данному списку
рассылки.
Что касается столбцов, то все отличия сводятся к добавлению нескольких
новых столбцов с шаблонами, к изменению имени столбца при вызове метода
DataBinder.Evaio, а также к изменению определенных свойств некоторых столб-
цов без шаблонов. Код, относящийся к этой странице, оказывается довольно длин-
ным. Ниже приводится его первая часть, в которой описывается комбинированное
окно и кнопка Send Email (отправка электронной почты):
HorizontalAlign= "Center ">Class="TextBoxrl AutoPostBaGk.= l!True"
OnSelectedIndexChanger-"ListsDropDown_IndexChanged" />
ID="SendEmail" CssClass="Button11
OnClick="SendEmail_Click" Width="100px" />
:
Необходимо обратить внимание на то, что свойству раскрывающегося окна
AutoPostBack присвоено значение true. Это приводит к тому, что страница будет
отправляться обратно каждый раз, когда пользователь изменяет выбранный эле-
мент. В свою очередь, это влечет за собой наступление события OnSeiectedmdex-
Changed И, Соответственно, ВЫЗОВ процедуры LiStsDropDown_IndexChanged() .
Остальная часть страницы аналогична тому, что мы видели раньше. Рассмотрим
дополнительные строки, которые были добавлены к объявлению таблицы данных:
AllowPaging="True" :.{..•
PageSize="20"
824 Практический пример
PagerStyle-HorizontalAlign=nRight"
PagerStyle-PageButtonCount=H20"
PagerStyle-Mode=IINumericPages"
OnPageIndexChanged="SubscrGrid_J?ageChanged11
В этих строках соответственно определяется, что данные будут выводиться
в виде страниц по 20 строк и что пользователь будет иметь возможность осущест-
влять поиск и перемещение по номерам страниц, расположенных внизу справа,
а также задается процедура, которая будет обрабатывать события, связанные с из-
менением страницы.
Код поддержки для Subscribers.aspx
Что касается кода на ASP.NET, то код поддержки для subscribers.aspx не
очень отличается от страницы Lists. В нем появилось несколько строк для работы
с вновь добавленными управляющими элементами. Этот код выполняется, когда
происходит загрузка страницы:
protected void Page_Load(object sender, EveiitArgs e)
{ . •
// получить ListID из QueryString
string ListID -Request.Params[*ListID"];
SubscrGrid.Attributes[••ListlD*]. = ListID;
.If (iPage, IsPostBack)
'{
// загрузить все доступные списки в управляющий элемент DropDown
NewsMailer.ListsDB lists.= new NewsMaiier.ListsDBCGetConnStringO);
DataView myDV = lists.GetListsO .Tables [0] .DefaultView;
ListsDropDown.DataSource ^ myDV;
ListsDropDown.DataBindO ;
If (ListID!=null)
{ ' . • ' . . ' : . : . • .. ^ .:• • ' - • . / • - " ; ' • , . ; ./• •
// выбрать элемент DropDown в соответствии с ListID
forearch (ListItem item in ListsDropDown.Items)
if (item.Value==ListID) s
ListsDropDown.Selectedlndex =
ListsDropDown.Items.IndexOF(item);
- ' • ••• " ••••••• • ' • • • " > • • • •••• ••• •'•• '• •" •: ; k Щ / Ж Ч './:•.•"•'•• v \ - ' : . . ' ; ; . Л : ; :" ;• :
V/ упорядочить управляющие элементы на странице
BindGridO ;
• > Ш-ШМ ^
> I ••":"-: Ш Ш ш
С правой стороны каждой строки таблицы на страннице Lists.aspx располага-
лась иконка, которая, при щелчке на ней мышью, переносила пользователя на
страницу subscribers.aspx, чтобы он мог просмотреть всех подписчиков данного
списка. Для этого использовалась ссылка на страницу subscribers.aspx, а в стро-
ку запроса в качестве параметра добавлялся идентификатор списка. Далее это
значение извлекается из строки запроса и сохраняется в качестве атрибута эле-
мента, управляющего табличным представлением данных, так как оно будет исполь-
зоваться в тот момент, когда в этом коде будет вызываться метод GetsubscribersO
для данного списка.
Двигаясь далее, мы обнаружим, что в дополнение к обычному вызову метода
BindGrid () на этот раз используется раскрывающийся список, который наполняется
имеющимися в наличии списками рассылки. Это осуществляется непосредственно
Практический пример 2 — Менеджер рассылки новостей в -режиме онлайн 825
внутри данной процедуры посредством обращения к методу GetListsO класса
ListsDB и привязки получаемой в результате таблицы в качестве источника данных
для управляющего элемента. Вновь добавленные элементы считываются один за
другим и выбирается элемент, идентификатор которого совпадает с идентификато-
ром, хранящимся в строке запроса.
В метод BindGrido ДДЯ этой страницы включен некоторый дополнительный код,
считывающий идентификатор списка, для которого требуется извлечь подписчиков,
и, кроме того, в ней ддя получения требуемого набора данных (то есть таблицы)
ИСПОЛЬЗуетСЯ класс SubscribersDB:
protected void BindGridO
- . _ {
int ListID;
// получить значение ListID из атрибутов Grid
if { SubscrGrid.Attributes[«ListID'1 1= null )
ListID = int. Parse(SubscrGrid.Attributes!"List-ID']);
else
ListID = int.Parse (ListsDropDown.SelectedI.tem.Value);
// получить всех подписчиков данного листа
NewsMailer.SubscribersDB subscribers =
new NewsMailer.SubscribersDB(GetConnString());
DataView myDV = subscribers.GetSubscribers (
ListID).Tables[OJ.DefaultView;
// отсортировать все записи в соответствии с
// атрибутом SortExpression DataGris
if ( SubscrGrid.Attributes['SortExpression*]! = " ';
myDV.Sort = SubscrGrid.Attributes["SortExpression"];
SubscrGrid.DataSource = myDV;
SubscrGrid.DataBindO ;
}
Эта функция отвечает за выбор элемента в раскрывающемся списке:
protected void ListsDropDown_IndexChanged(object sender. EventArgs e)
{
// загрузить страницу, чтобы показать записи выбранного листа
Response.Redirect ('Subscribers.aspx?ListID='r +
ListsDropDown.Selectedltem.Value);
•; -: : .•••:•-v' :: ""•: wu • :• ш . :'&ш&шшш^. шшшш. шшiiii .' '
В результате появляется возможность повторно направить браузер на ту же са-
мую страницу, но на этот раз с идентификатором выбранного элемента, что позво-
лит произвести загрузку соответствующих подписчиков при очередном обращении
К методу BindGrid ().
Когда пользователь двигается по другим страницам таблицы данных, необходи-
мо запретить переход в режим редактирования. Это означает, что, пока не будет
произведена повторная привязка таблицы данных, необходимо спрятать элементы,
управляющие добавлением новой строки, а также не выводить сообщение об
ошибке, которая возникает, если мы пытаемся добавить уже существующего
в списке подписчика. Необходимо присвоить свойству currentPageindex фактиче-
ское значение, для того чтобы внести изменения в текущую страницу:
protected void SubscrGrid_PageChanged(object sender,
DataGridPageChangedEventArgs e)
{
SubscrGrid.EditItemlndex = -1
AddError.Visible = false;
826 Практический пример
ShowAddNewControls(false);
// изменить текущую страницу для чтения данных
SubscrGrid.CurrentPagelndex = e.NewPagelndex;
BindGridO ?
В заключение процедура, которая обрабатывает событие, наступающее при на-
жатии кнопки Send Email, передает управление на страницу sendEmaii.aspx
с идентификатором текущего списка в качестве параметра — точно так же, как
это делалось для раскрывающихся списков:
protected void SendHmail_jClick(object sender, EventArgs e)
{
// вернуться к странице, чтобы отослать Email, •
// добавить значение ListID к QueryString
Response.Redirect("SerKiErna.il.aspx?ListID-" +
ListDropDovm.Selectedltem.Value) ;
Отправка электронной почты подписчикам
\
•:.:::|.S*-:J./iC«i5.Se;K«
ъ
v>ou(• • • - : -
использующейся по умолчанию SMTP-
службы, которая инсталлируется вместе
с Windows 2000 Server, поэтому не по-
требуется ни каких-либо дополнительных
средств, ни каких-либо серверов сторон-
них производителей для отправки сообще-
ний. Кроме того, можно предварительно
просмотреть сообщение, хотя при этом
строки, ограниченные символами " # " , не
транслируются, поскольку предваритель-
ный просмотр не является специфическим
для какого-либо конкретного подписчика.
На рисунке справа изображено предва-
рительное представление тела сообще-
ния с предыдущего рисунка.
Мы достигли критической точки в реализации при-
ложения — теперь требуется разработать и написать
код для страницы, которая позволяла бы администра-
тору составлять сообщение, рассылать его всем под-
писчикам из списка и заносить его в архив в БД для
последующего просмотра. Рисунок слева дает представ-
ление о том, как это все должно функционировать.
С помощью этой страницы администратор получает
возможность создать само сообщение, отправляемое по
электронной почте, и задать практически все опции,
касающиеся отправки сообщений, которые являются
общими для большинства клиентов: СС, ВСС, формат
электронного сообщения (простой текст или HTML),
приоритет, предмет сообщения и его тело. Кроме того,
можно использовать несколько отформатированных
специальным образом строк (располагающихся с правой
стороны), которые будут автоматически заменяться на
соответствующие им значения для каждого сообщения,
отправляемого по электронной почте посредством
-;'оч: -о' > -".- 1" :i2O«"5">*UstOosc.'ip
B-a&r tfSubscri ^ I - I . ^ L . >t-# tfSubscriberLa
is seme nsv?s about C#:
- you con use •" • ••-' A: v.-T y-: •»i dows ap
C i
racia^ o u r big « f f g r t t o p r o v i d e .you .wish frepi nov,'.-, -J.-<••
(ч# code sunipk%s, news, articles: Issue u, .1.2
1?ШЩщ^и '• . -
:гтт '." ;• ; t j , ^ v « . u ^ ^ ":: ;;;.•: ••;-;:;:;:^:'y •'-" "••:,•:•::;:•;;:::.:'
- ycu v.jj иге :: fa Ab°?,N£T .c.u W::...k-v.-? г^ргг • Of' r ,J :v;?- г..-jrt* *
','.> nor;1 you .;:•;>:•:<::;::= oyr b:^ tS't-rt Ю pow.:; yen r.'.th fresh ncv.-; v/l'i«
;ri;-J th;yi/'v у ом. j.,-!-r.».sn SMV^UJ lots of chocolate ,•*
: •;:.". Ш sparr lime If ус-иЧткс ^о
Практический пример 2 — Менеджер рассылки новостей в режиме онлайн 827
Страница SendEmaiLaspx
Страница ASP.NET содержит код, аналогичный коду, встречавшемуся ранее,
здесь он не будем воспроизводиться. Управляющие элементы в виде текстовых
окон, уникальные для данной страницы, используются для вывода значений
свойств NewsSubject и signature, которые хранятся в XML-файле с установками
и которые извлекаются кодом поддержки и передаются, странице.
Код поддержки для SendEamaiLaspx
Табличная сетка для вывода данных не используется на этой странице, поэтому
данный файл с кодом поддержки существенно отличается от тех двух файлов с ко-
торыми мы сталкивались перед этим. Рассмотрим код метода Page_Load(), в кото-
ром части программы, отличающиеся от предшествующих файлов, выделены
серым цветом:
// Используются две переменные для хранения конфигурационных установок
public string Signature_Value;
public string Subject_Value;
protected void Page_Load(object sender, EventArgs e)
{
string ListID = Request.Params["ListlD"]
if (IPage.IsPostBack)
// загрузить все списки, перечисленные в управляющем элементе DropDown
NewsMailer.ListsDB lists = new NewsMailer.ListsDB(GetConnString(});
DataView myDV = lists.GetLists().Tables[0].DefaultView;
ListsDropDown.DataSource = myDV;
// загрузить подписи и новые объекты из базы данных
NewsMaiier.Appsettings settings -
NewsMailer. AppConf ig.GetSettings (Server.MapPatMGetSettingsFile () ) ) ;
Signature_Value = settings.Signature;
Subject_Value = settings.NewsSubject;
Page.DataBind();
if (ListID!=null)
{
foreach (Listltem item in ListsDropDown.Items)
if (item.Value==ListID)
ListsDropDown.Selectedlndex =
ListsDropDown.Items.IndexOf(item) ;
Модуль NewsMailerConf ig используется для получения всех установок из XML-
файла, а сигнатура и предмет новостей сохраняются в общих переменных.
Заметьте, что имя файла, в котором хранятся установки, извлекается либо из
файла web.config, либо ИЗ КЭШ-памяти посредством функции GetSettingsFileO
класса Baseciass, а возвращенное значение преобразуется в реальный путь с по-
мощью вызова метода server.Mappathо, который позволяет получить полный путь
к файлу.
Когда выполняется метод DataBind о,осуществляющий привязку всех дочерних
управляющих элементов текущей формы к данным, то происходит привязка к зна-
чениям двух переменных — Signature_Value И Subject_Value — И ИХ ВЫВОД В тек-
стовых окнах.
828 Практический пример
Ниже приводится код для кнопки Preview:
protected void Preview__Click(object sender, EventArgs e)
V - , . V - : : ' \ •:; -; { " ;/:';- :.. •;.,••'•.,';:-: ••.'.•;•', : " t ' : - " . •"' : ' ! l ' - : : J y - • • ' ; ; : v . ...
string MsgText = . Body.Text;
: int ListID = int.Parse(ListsDropDown.Selectedltem.Value);
// заменить теги по спискам и установкам на их новые значения
MsgText = NewsMailer.Utilities.ProcessListTags(MsgText,
GetCoimS.tring () , List-ID) ;
MsgText = NewsMailer.Utilities.ProcessListTags(MsgText, GetConnString());
//осуществить кодировкутела, если это не формат HTML
if (FormatDropDown.SelectedIndex==0)
MsgText = HttpUtility.KtmlEncode(MsgText);
// заменить новые линии символами MsgText- MsgText.Replace("\пя, "<Ъх>");
// убрать символы возврата каретки
MsgText=...MsgText. Replace (• \r •",.•••);
MsgPreview.Text = MsgText;
MsgPreview.Visible = true;
В этом коде происходит вызов некоторых функций из класса u t i l i t i e s , кото-
рые осуществляют замены определенных тегов на соответствующие им значения,
кодирование текста в том случае, если в качестве формата выбран обыкновенный
текст (например, тег <ь> заменяется на ⁢b>), заменяют все переходы к но-
вой строке на тег #\п' и '\г' не распознаются в HTML. В завершение тело сообщения выводится
в управляющем элементе предварительного просмотра.
Перейдем к коду для кнопки Send Email:
protected void Send_Click (object sender, EventArgs e)
{ '
Server.ScriptTimeout = 3 600,-
Strins MsgBady = Body.Text;
Int ListID= int.Parse(ListDropDown.Selectedltem.Value);:
String MsgSubject = NewsMailer.Utilties.ProcessListTags(
Subject.Text, GetConnString(), List-ID) ;
NewsMailer.AppSettings =
NewsMailer.AppConfig.GetSettings(Server.MapPath(GetSettingsFile()));
NewsMailer.NewsHistoryDB news = new NewsMailer. NewsHistoryDB(
GetConnString());
// заменить теги по спискам и установкам на их новые значения
MsgBody = NewsMailer.Utilities.ProcessListTags(MsgBody,
GetConnString('), ListlDOf-
MsgBody - NewsMailer. Utilities. ProcessSettingsTags (MsgBody,
GetConnString());
// добавить новую запись в архив новостей
news .Add(ListID, MsgSubject,MsgBody, (FormatDropDown.SeleC:tedIndexs==l)'.) ;•
//создать новое почтовое сообщение
MaiMessage MailMsg = new MaiM^ssage () ;
MailMsg.From•= settings.SenderName•+ * <* + settings.SenderEmail. + ">";
MailMsg.Cc = CC.Text;
MailMsg.Bcc = BCC.Text;
Практический пример 2 — Менеджер рассылки новостей в режиме онлайн 829
MailMsg. Priority•.- (Mail-Priority) PriorityDropDown. Selectedlndex;
MailMsg.BodyFormat = (MailFormat)FormatDropDown.Selectedlndex;
MailMsg.Subject = MsgSubject;
NewsMailer.SubscribersDB subscribers = new NewsMailer.SubscribersDB{
. CetCormStringO ) ;
//получить всех подписчиков данного листа..:.-.
DataTabledt = subscribers.GetSubscribers(ListDB).Tables[0];
foreach (DataRow dr in dt.Rows)
•; и - Ш { • . ШшШ- ; Щ. •••'••' •
//заменить теги подписчика на их новые значения
MailMsg.То = (srting)dr["Email"];
MailMsg.Body = NewsMailer.Utilities.ProcessSubscriberTags(MsgBody,
' GetConnStringO , (int)dr["ID"]) ;
У/ послать это сообщение данному подписчику
SmtpMai 1. Send (MailMsg');'
;!:.;:: } . .; ' "
//показать количество отосланньЕх: сообщений
MsgPreview.Text = string.Format(
*dt. Rows .Count. ToString ()'•);
MsgPreview.Visible - true;
ШШ. ' • • I ' ; " ; . i $m ШШШШШШ^. Wm Ш Ш •-••••• ii ШВё il • • \ i : Ш . . t
Эта программа более длинная, но работает она аналогично Preview_ciick. Она
выполняет следующие шаги:
• Специальные теги, находящиеся в списке, и общие установки заменяются
на соответствующие им значения, а при необходимости производится
кодирование текста
• Сообщение добавляется в архив с помощью метода Add о
класса NewsHistory
• Создается объект MaiiMessage и присваиваются значения его свойствам,
общим для всех подписчиков
• Для получения всех подписчиков текущего списка используется
экземпляр класса SubscribersDB
• Для каждого подписчика, полученного в результате запроса,
производится установка его адреса электронной почты в качестве
адреса назначения для отправляемого объекта, после чего происходит
отправка почты
• В управляющем элементе предварительного просмотра выводится
число отправленных сообщений
В рассмотренном коде существует несколько моментов, на которые следует
обратить внимание. Прежде всего в дополнение к обычным пространствам имен,
которые объявлялись и для других страниц, на этот раз необходимо объявлять еще
и пространство имен system.web.Maii, содержащее в себе классы, позволяющие
создавать сообщения и отправлять их по электронной почте посредством использу-
ющейся по умолчанию SMTP-службы, инсталлируемой на Windows 2000 Server.
Следующий момент, на который следует обратить внимание, имеет отношение
к самой первой строке кода:
Server.ScriptTimeout = 3600;
830 Практический пример
Отправка отдельного сообщения — очень быстрое задание, однако если есть не-
сколько тысяч подписчиков, то на это может потребоваться значительное время —
несколько минут или даже больше. Те из вас, кто уже знаком с программирова-
нием на традиционном ASP, знают, что по умолчанию странице дается 90 секунд
на выполнение кода сценария и на отправку всего сгенерированного HTML-кода
браузеру. Это значение, использующееся по умолчанию, может быть изменено
администратором IIS, либо "зашито" в программу страницы — что мы в данном
случае и делаем, устанавливая максимальное время, в течение которого страница
должна завершить свое выполнение, равное одному часу.
Класс Utilities
В файле sendEmaii.cs с кодом поддержки для замены специальных тегов в теле
и предмете сообщения используется класс u t i l i t i e s . Ниже приводится исчерпы-
вающий список методов класса. Обратите внимание на то, что они описаны как
статические; это означает, что, для того чтобы ими воспользоваться, нет необходи-
мости создавать экземпляр данного класса:
Класс Utilities
Метод Описание
public static string ReadTextFile(string FilePath)
public static bool SaveRextFile(string FilePath,
string FileText)
public static string
ProcessListTags(string Message,
string ConnString,
int ListID)
public static string
ProcessSubscriberTags (string Message,
string ConnString,
int SubscrlD)
public static string
ProcessSettingsTags (string Message,
string SettingsFilePath)
Позволяет получать содержимое заданного файла
Сохраняет строку FileText в заданном файле
и возвращает логическое значение,
свидетельствующее об успешном или
неуспешном завершении операции
Заменяет теги списка, обрамленные символами "#",
на значения, хранящиеся в базе данных
Заменяет теги подписчика, обрамленные
символами "#", на значения, хранящиеся в БД
Заменяет теги установок, обрамленные
символами "#", на значения, хранящиеся в Б Д
List: [с*
<ИКЙЗ лф**& * vowС*1 w Ss*«e ^
С* - Jssua •» Г 07/li/Cl .:*
f7 uZ/lvi'i .,.'•
A
Работа
с архивом новостей
Страница архива новостей выводит все
предыдущие новости для всех списков
рассылки либо в виде прямого текста,
либо в виде HTML — в зависимости от
того, в каком формате они отправля-
лись. На рисунке слева представлен
внешний вид страницы архива.
Страница
NewsHistory. aspx
Эта страница использует управляю-
щий элемент табличного представления
данных, но вместе с тем она обладает
Практический пример 2 — Менеджер рассылки новостей в режиме онлайн 831
некоторыми уникальными особенностями. Обратите внимание на то, что выбран-
ный ряд выводится другим цветом, нежели все остальные, а у столбца ISHTML есть
окно выбора, указывающее на то, должен ли вывод производится в виде HTML.
Поле Date указывает на дату отправления данного сообщения. Поскольку большая
часть кода не отличается от кода предыдущих страниц, мы не будем приводить весь
текст полностью, а приведем только код, описывающий столбцы ISHTML И Date.
. . . Code removed for clarity
Readonly="True" SortExpression="Subject" />
ItemStyle-Width^'eQpx" IternStyle-Horizoni:alAlign = "Center">
;• • V: : : "Л(;):ф:. '•^•п:::у:. Checked='<%#
;-:;:;:.',:..;;:;.>-'-.,;::-:::;;:,::,:.y ••••,,:-
(bool)DataBinder.Eval(Container.Dataltem, "IsHTML")
/ > '""" ' . : : . . , ' . . • • • ' ^ / . ' ; • ' • " • . . ; • ; . . . ' . ; • ; : \ '
• SortExpre3sion=llSentDatetf ItemStyle-Width="9Qpx">
Text=='<%# string.Format(-{0:MM/dd/yy}",
DateTime.Parse(DataBinder.Eval(Container.Dataltem,
"SentDate") .ToStringO ) ) %>'
/>
' ••'• '.. ' :• : Как и для страницы Send Email, где мы привязываем общую переменную к текс-
товому окну, в данном случае столбец is HTML может использоваться в режиме
"только чтение", и в нем содержится отключенное окно выбора (отключенное,
поскольку информация о прошлых сообщениях не может изменяться администра-
тором посредством этой страницы), значение которого устанавливается в соответ-
ствии со значением поля ISHTML таблицы NewsHistory, хранящейся в базе данных,
и приводится к типу bool. .
Чтобы ПОЛуЧИТЬ Значения ПОЛЯ Date, ИСПОЛЬЗуеТСЯ меТОД DateTimeParse (), ПО-
ЗВОЛЯЮЩИЙ преобразовать строку из базы данных в значение типа DateTime, кото-
рое затем снова преобразовывается в строку для вывода на экран.
Код поддержки для NewsHistory. aspx
Пояснения, которыми мы сопроводим данный код, будут очень короткими, по-
скольку большая часть операций, уже обсуждалась для других файлов с кодом под-
держки. Единственной новой особенностью, заслуживающей обсуждения, является
процедура, обрабатывающая событие таблицы данных OnSelectedlndexChanged.
Когда некоторая строка оказывается выбранной, то тело соответствующего сооб-
щения извлекается, перекодируется в обычный тест и выводится в управляющем
элементе предварительного просмотра:
protected void NewsGrid_SelectionChanged(object sender. EventArgs e)
string Body;
. ..: NewsMailer.NewsHistoryDB news = new NewsMailer.NewsHisroryDB (GetConnStringO );
832 Практический пример
If получить ID выбранной строки
int NewsID = int.Parse(NewsGrid.DataKeys[NewsGrid.Selectedlndex].ToStringO);
// получить массив новостей из базы данных
Body = news. GetDetails(NewsID) ['Body].ToStringO;
// если формат новостей не HTML, осуществить кодировку текста Body
if (]Convert.ToBoolean(news.GetDetails(NewsID)["IsHTML"]))
Body = HttpUtility.HtmlEncode(Body);
// заменить новые строки символами Body = Body.Replace (Ли* , " ,Ъг>п) ;
Body = Body. Replace ( *\*r", " ") ;
// показать тело Body в элементе "предварительный просмотр*
MsgPreview.Text - Body;
Msg Preview.Visible = true;
Обратите внимание на то, что нам не приходится в данном случае заменять ни-
каких специальных тегов, поскольку все они были заменены перед тем, как сооб-
щение было помещено в архив, хранящийся в базе данных.
Кроме того, в тот момент, когда администратор изменяет просматриваемую
страницу таблицы данных, нам необходимо отказаться от выбранной строки, по-
скольку эти действия автоматически не выполняются:
protected void NewsGrid_PageChanged(Object sender, DataGridPageEventArgs e)
{
UnselectGridltemO ;
/ / изменить текущую страницу для чтения данных
NewsGrid.CurrentFagelndex - e.NewPageIndex;
BindGridO ;
}
protected void UnselectGridltemO
{
// спрятать элемент "предварительный просмотр"
NewsGrid.Selectedlndex = -1;
MsgPreview.Text = * T;
MsgPreview.Visible ~ false;
Ш
!tewt&«»tr««r - " - < - • • ; „ • 0 "
- • - ; '• * , .*•-- **
. . ,_„ .. :
МЙММЯМ л
В
Изменение установок
в режиме онлайн
Нам уже неоднократно приходилось использо-
вать значения, хранящиеся в XML-файле с установ-
ками NewsMailer. Settings, которые МЫ определили
в момент создания этого файла. Теперь нам потре-
буется web-страница, позволяющая модифицировать
эти установки в режиме онлайн — без необходимо-
сти садиться перед web-сервером и вручную вно-
сить изменения в базу данных. Страница, о которой
идет речь, изображена на рисунке слева.
Практический пример 2 — Менеджер рассылки новостей в режиме онлайн 833
Страница Settings.aspx
Страница ASP.NET формируется с помощью набора управляющих элементов,
к которым привязываются соответствующие установки, хранящиеся в базе данных
Settings. Они привязываются к общим переменным, значения которых задаются
в коде поддержки, как и для страницы Send Email. Настоящая страница является
очень большой, для иллюстрации ее работы мы приводим участок кода, в котором
описывается поле Sender Email, а также происходит наполнение соответствующего
текстового окна с выполнением дополнительной проверки допустимости:
Сlass-"TextBox" Text='<%# SenderEmailJValue %>' />
ContrclToValidate--" SenderEnia.il" ..
Display="dynamic">' ' validationExpression^". *§. *\ . . *w
ControlToValidate="SenderEmail"
Display= "dynamic">Приведенный выше управляющий элемент является особенным, поскольку
в нем присутствует не один, а два элемента, предназначенных для проверки допус-
тимости: один из них позволяет гарантировать, что текстовое окно не является пу-
стым в момент отправки формы, а второй — что строка с адресом электронной
почты представлена в допустимом формате. В последнем случае используется
ReguiarExpressionVaiidator, и, как следует из его названия, он выполняет про-
верку допустимости регулярного выражения. В настоящем примере используется
следующее выражение:
validationExpression=" . * @ . * \ . .*" .. : . ;:':::'::: ;4v> •;-*•;: • '••-.••.•:.r'::'.:"','--'::/-ControlToValidate="SenderEmail"
Display="dynamicI1>Это означает, что строка должна начинаться с символов (.*), затем в ней должен
находиться символ '@', потом произвольные символы, затем точка (для которой
используется escape-последовательность \.) и, наконец, произвольные символы.
Например, mbeiiinaso@vb2themax.com представляет собой допустимый адрес элек-
тронной ПОЧТЫ, В ТО время KaKmbellinaso@vb2themax ИЛИ mbellinaso.libero.it —
недопустимые адреса.
Регулярные выражения представляют собой весьма мощный инструмент для
проверки допустимости содержимого управляющего элемента, поскольку названные
выражения могут быть детальными и сложными; их использованию посвящены
целые книги. Кроме того, существует возможность при написании функции, произ-
водящей проверку допустимости, использовать метод CustomVaiidator, который
позволяет осуществлять еще более жесткий контроль.
834 Практический пример
Код поддержки для файла Settings.aspx
Код поддержки для внесения изменений в установки состоит из двух процедур:
одна из них — это метод Page_Load(), предназначенный для извлечения установок
из базы данных с помощью объектов AppConf ig и AppSettings и привязки их к со-
ответствующим серверным управляющим элементам посредством вызова метода
Page.DataB ind():
protected void Page_JL.oad(object sender,EventArgs e) •
• • • ••• • " V • < ./ .. • • ; ' -
if ( UsFostBack) ;
ШЩ••/.••:• "' • , ^ < ' •' ••••"•;' ;
// загрузить Бее установки
NewsMailer.AppSettings settings =
NewsMailer. AppConf ig GetSettings (Server.MapPath(GetSettingsFiIe ().).);
SubscribeURL_Value - settings.SubscribeURL;
SenderName_Value = settings.SenderName;
SenderEmail_Value ~ settings.SenderEmail; :
NewsSubject_Value = settings.NewsSubject;
SubscrSubject_Value = settings.SubscrSubject; : ;
; SubscrMessage__Value - settings.SubscrMessage; : : •{.
UnSubscrSubj ect__Value = settings.UnSubscrSubject;
x : :: . •'; UnSubscrMessage_Value = sett ings. UnSubscrMessage;
; Signature_Value = settings.Signature;
. SendSubscrEmai'lJvalue = sett ings. SendSubscr Email;
SendUnSubscrEmail_Value,= settings.SendUnSubscrEmail;
••• ':' ••';• .:• , • '•.'•,•..,•'• : .: •,• • P a g e . D a t a B i n d ( ) . ; . ' . • , . ; .••••':. , . '/•..••'•'- ; . . : ; ' ' V ';.}:•:',•/'•''.'.[ . . . ... . .
Вторая процедура — это update_ciick(), которая вызывается в момент, когда
мышь щелкает кнопку Update. Эта процедура собирает новые значения установок,
находящиеся в управляющих элементах, присваивает их свойствам нового объекта
AppSettings и вызывает метод SaveSettings о объекта AppConf ig для сериализа-
ЦИИ объекта settings В XML-фаЙЛ (в данном Случае — В NewsMailer. Settings):
protected void Update_Click{object sender,EventArgs e)
. . { . •. •, . • • • • . ' • : , • • . . • . • • • •: ;;. : ' " : . v . . • •'; v
NewsMailer.AppSettings settings = new NewsMailer.AppSettings();
// установить новые значения для всех свойств
settings.SubscribeURL = SubscribeURL.Text;
settings.SenderName = SenderName.Text ; ; •;
settings.SenderEmail -SendarEmai.Text ; :
settings.NewsSubject = NewsSubject.Text; :
settings.SubscrSubject = SubscrSubject.Text;
settings.SubscrMessage ~ SubscrMessage.Text;
settings.UnSubscrSubject = UnSubscrSubject.Text;
settings.UnSubscrMessage = UnSubscrMessage.Text;
settings.Signature = Signature.Text ;
settings.SendSubscrEmail = SendSubscrEmail.Checked;
settings.SendUnSubscrEmail'= SendUnSubscrEmail.Checked;
NewsMailer .AppConf ig. SaveSettings (Server. Map?ath( Get Sett ingsFil.e (.)•) , settings) ;
Изменение внешнего представления в режине онлайн
В самом начале этого раздела говорилось о том, что все стили для управляю-
щих элементов хранятся в отдельной таблице стилей, а не внутри страницы. На
самом деле, "зашитые" в программу цвета и другие параметры стилей внешнего
Практический пример 2 — Менеджер рассылки новостей в режиме онлайн 835
il
Тле eg
СсГг cJiapqt» any <«lir.bu:e of c-rv/ HTN'.L Sfement (ca'or
;?'u: x.;r,-.5:i\efi«'".iJ -'•--=, sans-serif;
font: м J>ml V^rdanii, AriaL sans-serif;
1ЙЖ--Г'"'"
^ : / - «is
I
•;.c>... ;h:;< ->г.у|й sheet used by ever,1 paqo. Vou
i, uz<: tv.c.) зг>й «fror> press ?ha Updato button to
1
J
!•
_J
представления всегда оборачиваются
головной болью, когда необходимо
внести какие-либо изменения, так как
приходится вручную проходить по
всем страницам и изменять все вхож-
дения для стиля, который мы хотим
модифицировать. Наличие таблицы
стилей позволяет существенно упрос-
тить жизнь. Однако, все равно было
бы хорошо иметь возможность редак-
тировать таблицу стилей в режиме
онлайн, вместо того, чтобы вносить
изменения в файл на локальном
компьютере, а затем отправлять этот
файл обратно на сервер. Реализация
страницы, которая позволяет редакти-
ровать файлы, требует всего лишь не-
скольких минут и нескольких строк
кода, и к созданию именно такой стра-
ницы мы сейчас и приступим.
На рисунке слева представлен наш
простой редактор таблиц стилей.
Если вы знаете CSS, то вы получаете возможность изменять стили управляю-
щих элементов ASP.NET, а полное изменение стиля всего пользовательского ин-
терфейса — это вопрос нескольких секунд!
Страница Layout.aspx
Этот файл не очень отличается от других управляющих элементов ASP.NET,
поэтому мы не будем приводить здесь весь код полностью. Изображенная ниже
строка кода, однако, требует дальнейших пояснений:
В этой строке объявляется скрытая надпись, которая используется для задания
имени файла, подлежащего редактированию.; это означает, что, изменяя эту уста-
новку, мы получаем возможность редактировать произвольный текстовый файл.
Администратору по-прежнему необходимо выполнить повторную загрузку, если он
изменяет путь к файлу в скрытых управляющих элементах, однако это оказывается
намного проще и быстрее, чем изменять значения в файлах с кодом поддержки,
поскольку в таком случае приходится заново транслировать и загружать весь мо-
дуль. Всегда помните, что приложение должно распространяться в откомпилиро-
ванном виде, а отсюда следует, что если какая-нибудь установка будет "зашита"
в программу, то это приведет к тому, что администратор сайта, работающий уда-
ленно, окажется не в состоянии изменить ее без помощи разработчи

Управление конфигурацией данных

basic — Wed, 10 Feb 2010 22:00:05 GMT

Управление конфигурацией данных
Программа рассылки новостей может быть настроена со спе-
циальными подтверждениями, именем и электронным адресом
администратора, и некоторыми другими опциями (со всеми воз-
можными опциями мы вскоре познакомимся). Использование же-
стко заданных в программе значений этих опций является плохим
подходом, так как при возникновении у администратора необходи-
мости изменить некоторую опцию (например, свой адрес элект-
ронной почты), ему придется вносить соответствующие изменения
в исходный код, компилировать весь проект заново и загружать
новый модуль. Это серьезная проблема, особенно если админист-
ратор сайта не является программистом. Поэтому мы будем хра-
нить все установки в виде внешнего файла, из которого их будет
очень просто считывать и записывать, а также выводить на стра-
ницу, позволяя администратору с легкостью изменять любые
значения без повторной компиляции и перезагрузки.
XML-файл установок
Все установки обычно хранятся в базе данных или в текстовом файле. Если
выбрать базу данных, то потребуется завести целую таблицу для хранения всего
лишь нескольких установок. Можно бы хранить все установки либо в одной строке
(со многими столбцами), либо по одной установке в каждой строке. Такое решение
оказывается весьма простым — просто еще одна таблица и еще один класс в мо-
дуле NewsMailerDB, однако оно означает неэффективное использование ресурсов
базы данных. Хорошим решением является использование XML-файла, который
обладает вполне подходящим форматом для хранения установок приложения.
В .NET Framework также предусмотрены классы, позволяющие легко считывать
и записывать все установки и представлять их в виде свойств класса несколькими
строками кода. Этот код будет рассмотрен ниже, а пока начнем с объяснения са-
мих установок.
Файл NewsMaiier. settings используется для хранения строки соединения с ба-
зой данных всех установок, а также приложения за исключением касающихся
внешнего представления приложения. Все возможные установки перечислены
в приводимой ниже таблице.
Установки NewsSubject, [Un]SubscriptionSubject И [Un]SubscriptionMessage
могут содержать в себе специальные теги, например, #subscriberFirstName# или
806 Практический пример
#ListDescription#, которые будут заменяться на соответствующие им значения
перед отправкой каждого сообщения. Позднее в настоящем разделе мы детально
разберем эту возможность.
Название установки Тип
Допускается
значение null Описание
SenderName
SenderEmail
NewsSubject
string
string
string
Да
Нет
Нет
Signature
SubscriptionSubject
SubscriptionMessage
UnSubscriptionSubj ect
UnSubscriptionMessage
SendSubscriptionEmail
SendUnSubscriptionEmai1
SubscribeURL
string
string
string
string
string
bool
bool
string
Да
Нет
Да
Нет
Да
Нет
Нет
Нет
Имя отправителя новостей
Адрес электронной почты отправителя
новостей
Предмет новостного сообщения,
использующийся по умолчанию.
У администратора есть возможность
создать сообщение, добавив произвольный
текст к этой строке непосредственно
из страницы
Подпись, которая будет автоматически
добавляться в конец сообщения
Предмет сообщения, отправляемого
по электронной почте в качестве
подтверждения успешной подписки
Тело сообщения, отправляемого
по электронной почте в качестве
подтверждения успешной подписки
Предмет сообщения, отправляемого
по электронной почте в качестве
подтверждения успешного отказа
от подписки
Тело сообщения, отправляемого
по электронной почте в качестве
подтверждения успешного отказа
от подписки
Если это значение равно t r u e , то новые
подписчики будут получать по электронной
почте подтверждение о том, что подписка
прошла успешно
Если это значение равно t r u e ,
то существующие подписчики будут
получать по электронной почте сообщение
о том, что их подписка завершена
Полный URL страницы Subscribe.ASP.NET,
который используется для добавления или
удаления пользователя из списка
В этой таблице приводятся различные типы установок; все установки хранятся
в XML-файле в виде строк. Этот тип обозначает тип свойства класса, которому
(свойству) соответствует значение данной установки. Столбец "Допускается значе-
ние null" имеет аналогичный смысл: в нем описываются установки, которые могут
отсутствовать в файле установок. Не существует никакого файла со схемой, кото-
рая позволяла бы получать подтверждение того, что та или иная установка на
самом деле присутствует в файле установок — страница ASP.NET, которая ис-
пользуется для их считывания и изменения, отвечает за сохранение допустимости
структуры файла.
Практический пример 2 — Менеджер рассылки новостей в режиме онлайн 807
XML-файл выглядит приблизительно следующим образом:

; , • ••,'•••<•/ A p p S e t t i n g s >
Модуль NewsMailerConfig
Сериализация объекта — это процесс сохранения состояния данного объекта
в памяти или в виде постоянного двоичного или ASCII-файла. Под состоянием
объекта понимается множество всех его свойств, значений и ссылок на другие
объекты. Напротив, десериализация приводит к созданию нового объекта, состоя-
ние которого определяется данными, хранящимися в некотором файле. .NET Framework
существенно упрощает выполнение сериализации и десериализации за счет
множества классов, которые позволяют работать с несколькими различными фор-
матами хранения.
Если вы используете VS.NET, создайте для начала новый проект типа class
Library и переименуйте установленный по умолчанию файл класса в AppConfig.cs.
Если вы набираете текст с помощью текстового редактора, то сохраните этот файл
в директории NewsMaiier\config. Ниже приводится сводная таблица класса
AppSettings, который отвечает за создание XML-файлов, подобных приведенному
выше, из сериализованных экземпляров. Этот файл состоит из множества общих
свойств, имена которых совпадают с именами соответствующих свойств из XML-
файла.
Все свойства класса AppSettings помечены атрибутом XmlElement. Это сделано
именно так, поскольку требуется, чтобы все эти свойства могли быть сериализова-
ны в виде XML, а для этого используется класс xmiseriaiizer из пространства
имен System.Xml.Serialization. Поскольку класс AppSettings не обладает мето-
дами, позволяющими ему сериализовать и десериализовать себя, эта задача возла-
гается на класс поддержки AppConfig, также хранящийся в файле AppConfig.cs.
Вот содержимое этого класса:
Класс AppConfig
Метод Описание
public static AppSettings GetSettings (string fileName) Находит XML-файл, в котором хранятся
все установки, и создает объект класса
AppSettings, содержащий эти данные
public static void SaveSettings (string fileName, Получает объект AppSettings
AppSettings data) и записывает хранящиеся в нем данные
в указанный XML-файл
808 Практический пример
Эти два метода достаточно сложны, поэтому мы объясним их более подробно.
Для начала приведем код метода GetSettingsO:
public static AppSettings GetSettings(string fileName)
;: HttpContext = HttpContext.Current;
AppSettings data = (AppSettings)context.Cache["AppSettings*];
if (data == null)
{
XmlSerializer serializer = new XmlSerializer(typeof(AppSettings));
try
{
// создать файловый поток для чтения XML-документа
: FiieStream fs = new FileStream(filename. FileMode,Open);
XmlReader ~ new XmlTextReader (fs);
: i;; : // посмотреть состояние объекта :
data - (AppSettings)seriallizer.Deserialize(reader);
reader.CloseO ;
: : : ; ; context.Cache.Insert(•AppSettings", data,
: new CacheDependency(filename));
} ' "'..' ..;,-:
:;
• : catch (System.10.FileNotFoundException) ; :
{ ••'.'• ' ' :.--:.: ••:•
// если файл не найден, вернуть новый пустой класс
data = new AppSettings () ;
) ' I • l l l l i l l
return data;
}
Прежде всего данный метод осуществляет проверку, не находится ли объект
с данными установками в кэш-памяти, куда он попадает при первом обращении
к методу. Если объект уже находится в кэш-памяти, то метод GetSettingsO про-
сто возвращает эти данные. Если объект в кэш-памяти отсутствует, то сначала со-
здается объект XmlSerializer, затем осуществляется открытие параметра файла,
указанного в качестве первого, после чего для потока файла создается объект
XmlTextReader. В завершение состояние объекта извлекается посредством метода
Deserialize () объекта XmlSerializer, а ПОЛученНЫЙ В результате всех ЭТИХ дей-
ствий объект AppSettings помещается в кэш-память для последующего использо-
вания.
В этой программе есть несколько примечательных моментов. Первый заключа-
ется в том, что путь к файлу с установками не "зашит" в программу, а передается
в качестве параметра. Это необходимо, поскольку данный код будет откомпилиро-
ван в модуль и может быть использован произвольным клиентом, поэтому файл
с установками может располагаться в различных местах.
Вторым любопытным моментом является способ, с помощью которого установ-
ки переносятся в кэш. Обратите внимание на следующую строку кода:
Context.Cache.Insert("AppSettings", data, new CacheDependency(fileMame));
Третий параметр означает, что информация, хранящаяся в кэш-памяти, зависит
от файла, который передается в качестве параметра. Если этот файл обновляется,
то информация, хранящаяся в кэш-памяти, более не считается правильной, поэто-
му при повторном обращении к установкам необходимо выполнить десериализа-
цию файла еще раз. Тот факт, что состояние файла отслеживается автоматически,
Практический пример 2 — Менеджер рассылки новостей в режиме онлайн 809
является замечательной особенностью кэширования в ASP.NET, которая позволя-
ет вносить изменения в содержимое файла установок с помощью произвольного
редактора, перезагружать файл и при этом знать, что все установки будут перезаг-
ружены в кэш-память.
И последний момент: когда состояние объекта перезагружается из файла, то
все установки, хранящиеся в XML-файле в виде строк, автоматически приводятся
к тому типу, которым обладает соответствующее свойство.
Метод Savesettingso обладает структурой, аналогичной структуре метода Get-
Settings О:
" public static void SaveSettings(string FileName, AppSettings data)
{
XmlSerializer =; new XmlSerializer (typeof (AppSettings) );
II Создать XmiTextWriter используя FileStream
FileStream fs = new FileStream(fileName, FileMode.Create);
XmiTextWriter writer = new XmiTextWriter (fs, new UTF8 Encoding'() ) ;
// Осуществить сериализацию, используя XmiTextWriter
serializer.Serialize(writer, data);
writer.Close();
ЩщЩташш
i *j
- Ш References
|
I L~ Ш AssembiyInfoConf.es
ЁЗ- • Ш NewsMailerDB
^ Solution Explorer | Единственный новый момент заключается в том, что некото-
рые символы, например '<' и '>', кодируются, поскольку с точки
зрения XML они обладают особым смыслом (они используются
для обрамления XML-тегов). Способ такого кодирования задает-
ся В КОНСТрукторе объекта XmiTextWriter.
Компиляция модуля
Если вы вели разработку в Visual Studio.NET, то ваш Solution
Explorer должен принять вид, изображенный на рисунке слева.
При этом в режиме Class
картинка, представленная на
View должна выводиться следующая
рисунке справа.
Управление
пользовательским интерфейсом
Разработка базы данных и бизнес-классов завершена, т. е.
большая часть работы уже выполнена. Теперь мы собираемся за-
няться разработкой пользовательского интерфейса приложения,
а также использовать бизнес-классы для чтения и записи данных
из базы данных.
Прежде чем переходить к рассмотрению кода на ASP.NET
и С#, взглянем на некоторую часть результатов, к которым мы
стремимся (см. рис. на стр. 810).
Страница, изображенная на указанном рисунке, позволяет ад-
министратору просматривать имеющиеся в наличии списки рас-
сылки, создавать, уничтожать или редактировать эти списки,
а также переходить к списку подписчиков или к другим страницам
приложения. В таблице на данной странице показаны все списки,
которые были получены из базы данных, в ней также выводятся
• ^ Е Я Е
е - о w«
и
1•
>.. • ,t,\M,i '-, ~*
miiTHiii
-г,ф (JetOc{«!s(ir»t)
•**£ Bases ^tnd Merf^ces
*i|# AdtffUMtrinQj »Ь*ЧЬ string)
-%ф 6atSJw• ? F : . - * Г .
810 Практический пример
IS 11 Usls f Subsetors i SoniJFn
jjs^nd 5fi^ £rnsi to a list *•
ШШЯ
ij? 2Г i VB.NST
j j f Ш z * A S P J M S T г *
i
ШИШ
Visual Basic.NET- оё¥« rui ц
rd 1 Settings i
I! <**
Щ
1>
их свойства и предусматривается воз-
можность их сортировки по значению
одного из следующих свойств: ID,
Name, Description. Все ИКОНКИ, ВЫВО-
дящиеся в таблице (рисунки, распо-
ложенные левее столбца ID И правее
столбца Description), представляют
собой гиперссылки на другие страни-
цы, позволяющие выполнять какие-
либо другие действия над данным
списком или над данной строкой.
Ниже приводится перечень иконок,
которые могут располагаться внутри
таблицы с описанием выполняемых
ими действий.
Если вы когда-либо программиро-
вали на обычном ASP, то вы, вероятно,
думаете, что для этой таблицы потре-
буется большой объем сложного кода,
позволяющего управлять гиперссылка-
ми, рисунками, изменением цвета строк,
сортировкой данных и т. п. Но вы уди-
витесь, насколько просто всего этого
можно добиться с помощью ASP.NET
и нескольких строк кода на С#.
Все приложение состоит из несколь-
ких страниц ASP.NET, большинство из
которых относится к административно-
му разделу. На диаграмме (см. стр. 811)
приводится стандартное расположение
страницы, а также полный список всех
страниц, имен файлов, в которых они
хранятся, и соответствующих файлов
и классов с кодом поддержки.
Иконка Описание
_
Редактирование записи
Удаление записи
Переход на страницу, на которой выводятся
подписчики данного списка рассылки
Переход на страницу, на которой выводятся
прошлые сообщения, отправленные
в соответствии с данным списком рассылки
Переход на страницу, на которой составляется
и отправляется новое сообщение подписчикам,
входящим в данный список рассылки
Создание
пользовательских управляющих элементов
Если есть некоторые составные части пользовательского интерфейса, которые
требуется использовать более, чем на одной странице, то следует подумать о том,
каким образом можно использовать код повторно без копирования и переноса его
из одной страницы в другую. В данной программе мы хотим иметь возможность
общего использования заголовка и нижней части страницы, которые соответствен-
но представляют собой верхнее меню и маленькую иконку, расположенную внизу
справа непосредственно под таблицей и позволяющую возвращаться на начало
страницы. В традиционном ASP потребовалось бы включить два отдельных файла
посредством директивы натива — пользовательские управляющие элементы. С их помощью можно выде-
лить общий код в отдельный файл, который может быть в дальнейшем использован
везде, где в этом возникнет необходимость, путем присваивания имени импортиру-
емому управляющему элементу, изменения его общих свойств или вызова общих
Практический пример 2 — Менеджер рассылки новостей в режиме онлайн 811
Меню
(Header.ascx)
Страница ASBNET
Нижняя часть
(Footer.ascx)
Страницы ASP.NET
Страницы управления Прочие страницы
щ
i l l
ь о
Модуль NewsMailer.dll (классы кода поддержки)
со со
Si 8%
&9
методов, которыми он обладает. Другими словами, это не просто участок кода,
вставляемый в нашу страницу, он представляет собой графический компонент,
обладающий собственным именем и атрибутами. Являясь серверным компонентом,
он, как и другие серверные компоненты ASP.NET, обрабатывается на сервере,
а все, что получает браузер пользователя, — это стандартный HTML, совмести-
мый с любым браузером.
В нашем проекте используются два пользовательских управляющих элемента:
Пользовательский
управляющий элемент Описание
Header.ascx
Footer.ascx
Осуществляет добавление заголовка, общего для всех страниц web-сайта.
Этот управляющий элемент состоит из трех частей:
• Раздел заголовка, представленного в виде таблицы,
в которой хранятся текст и логотип.
• Еще одна таблица, в которой хранятся ссылки на другие web-страницы.
• Надпись, представляющая собой текст, который описывает
каждую из ссылок, когда на нее указывает курсор мыши.
Содержит всего лишь образ ссылки, которая переносит пользователя
обратно на начало страницы.
812 Практический пример
Использование пользовательских
управляющих элементов на web-странице
Чтобы использовать управляющий элемент из web-страницы, необходимо заре-
гистрировать его из этой страницы, указав имя исходного файла и префикс, позво-
ляющий отличать его от других серверных управляющих элементов. Следующие
две строки должны быть включены в начало страницы:
<%@ Register TagPrefix=!lNewsMailer" TagName--"Header" src-"Header.ascx" %>
<%@ Register TagPrefJ.x-!1NewsMailer" TagName="Footer" src="Footer.ascx11 %>
Ниже приводится код, который позволяет добавить пользовательские управля-
ющие Элементы Header И Footer на обычную Страницу:
Страница управления списками
На ранее представленном рисунке страница управления списками рассылки
изображена в том виде, в каком она появляется на экране сразу после загрузки.
Однако ее внешний вид может претерпевать определенные изменения в зависи-
мости от предпринимаемых дей-
ствий. Вот что вы увидите, если
нажмете на иконку с изображе-
нием блокнота и ручки, располо-
женную у самого левого края,
для того чтобы отредактировать
список (см. рис. слева).
Свойства Name И Description
текущей страницы выводятся
внутри двух текстовых окон, и у
администратора есть возмож-
ность изменить эти значения,
после чего щелкнуть мышью
либо на зеленой иконке с галоч-
кой, чтобы сохранить эти изме-
нения в базе данных, либо на X,
для того чтобы отказаться от этой операции. Обратите внимание на то, что стол-
бец ID не подлежит редактированию, поскольку он используется в качестве счет-
чика и его значение не может быть изменено, а также на то, что списки
отсортированы по имени, а не по ID, как прежде. Для сортировки необходимо
щелкнуть мышью на заголовке того столбца, по значениям которого вы хотите
произвести сортировку.
Hosting offers izt ASP.NgT applications
vjsva? BssfciiST • ftfcwi and tips
Практический пример 2 — Менеджер 'рассылки новостей в режиме онлайн 813
Для того чтобы добавить новый список, администратор должен щелкнуть мышью
на кнопке Button, расположенной слева вверху основной страницы. Вот к какому
результату это приведет:
Add New Mame iOescription
I
На экран выводятся два пустых текстовых окна, и администратор заполняет их,
вводя названия и описание того списка рассылки, который он собирается созда-
вать. Выполнение этой операции может быть подтверждено или отменено посред-
ством двух иконок, расположенных с левой стороны. В обоих случаях (это также
справедливо и для редактирования) текстовые окна убираются, а картинка возвра-
щается к своему первоначальному состоянию. Если нажать иконку для редактиро-
вания новой строки, то такой эффект достигается почти автоматически, и тогда
при добавлении новой строки приходится обрабатывать события управляющих
элементов для вывода или свертывания текстовых окон самостоятельно. Этот про-
цесс оказывается намного проще, чем может показаться на первый взгляд — для
его осуществления необходимо написать всего лишь несколько строк кода, к чему
мы перейдем буквально через минуту.
Страница Lists\aspx
Это страница ASP.NET, в которой описывается пользовательский интерфейс;
в ней может также храниться код описания сценария, как и на страницах ASP.
Одно из наиболее значимых преимуществ ASP.NET заключается в том, что код
оказывается отделенным от пользовательского интерфейса за счет использования
файлов с кодом поддержки — этот термин мы будем очень часто использовать по
- ходу настоящего раздела (и который мы уже несколько раз использовали, не давая
ему определения). В файле с кодом поддержки находится один или более классов,
которые обрабатывают все события, возникающие в web-странице. Разделение этих
двух уровней позволяет web-дизайнеру вносить изменения во внешнее представле-
ние web-страниц без необходимости разбираться в запутанном коде на VBScript
или Jscript, который распределен по всей странице вперемешку с HTML-кодом.
Файлы с кодом поддержки могут быть откомпилированы в отдельный модуль, что
существенно упрощает установку приложения (поскольку в этом случае приходит-
ся загружать только один DLL-файл вместо нескольких исходных файлов с кодами
на С#) и повышает уровень обеспечения безопасности вашего приложения в том
смысле, что если кто-то получит доступ к серверу, то он не сможет также быстро
прочитать бизнес-код, как в случае с ASP.
Чтобы создать страницу Lists.aspx в VS.NET, выберите пункт меню Project |
Add Web Form. При работе в любом другом редакторе просто создайте новый файл
В папке NewsMailer.
Исходный код для этой страницы слишком велик, чтобы приводить его цели-
ком, поэтому будем останавливаться только на тех его участках, которые представ-
ляют для нас интерес как для программистов на С#. В первой строке содержится
описание того, какой базовый класс используется при обработке событий, возни-
кающих на данной странице:
<%@ Page language=nc#" Inherits^"NewsMailer.Lists" %>
814 Практический пример
В этом классе содержится весь код, который выполняется при загрузке данной
страницы при нажатии клавиши, а также когда мы хотим добавить, удалить или
отредактировать какой-либо список рассылки. Этот класс, называющийся Lists,
входит в состав пространства имен NewsMaiier и компилируется в отдельный мо-
дуль NewsMaiier.dll, к рассмотрению которого мы перейдем позднее. Страница
автоматически просматривает папку с именем bin в корневой web-папке, находит
модуль и реализует наследование от этого класса. Файл, в котором содержится ис-
ходный код на С# (в данном случае это файл Lists.cs), представляет собой файл
с кодом поддержки.
Двигаясь далее по телу страницы, мы обнаруживаем форму с кодом для середи-
ны web-страницы, расположенной между заголовком и нижней частью страницы.
Первое, на что мы обращаем внимание,— это кнопка Create в верхнем левом углу
непосредственно под заголовком. При нажатии этой кнопки появляются два тек-
стовых окна и две иконки — для подтверждения и для отказа от данной операции,
которые были продемонстрированы ранее. Остальная часть страницы остается без
изменений. Ниже приводится код для этой кнопки:
....... .... ... . . : , : ID=HCreate_Clic}cfl Width="80px"
OnClick="Create_Click1' Width="80pxn
/>
• ; : .'• ••:•• • .•• •, •• • < / a s p : T a b l e C e l l > • •• ••• .•.•••••••••.•,.•,•:•.••••• •• . • • • •• : •,. : • • ••• „ • / . .
Далее идет строка таблицы, по умолчанию являющаяся невидимой, но которая
становится видимой при щелчке мышью на кнопке Create. Эта часть программы
позволяет модифицировать список и принять сделанные изменения или отказаться
от них:
• Width=n15px"•.;Height ="lpx" runat="server" /•>••:
Text="• Alt='Add new list'>" .
: OnClick-"AddNew_Click" • :
. ; • . . ; , : . .. /> • • • •
Width="15px" Height="lpx" runat-"server" />
runat="server" CausesValidation="false?l
Text="Alt='Cancel editing mode'>"
OnClick-11 Cancel AddNew_C.lick11
/> '§шшшйi : ^ ш ш ш ^ м ш щ : \ • •-•;.':.:"
• ••••• : ш
ID="NewListName" Width="150px" />
: : - runat="server" COntrplToValidate="NewListName/
Displays"dynamicM. Практический пример 2 — Менеджер рассылки новостей в режиме онлайн 815
ID="NewListDescr" Width="450px" />
Обратите внимание на то, что все серверные управляющие элементы, к кото-
рым требуется обеспечить доступ программным путем, обладают атрибутом ID,
а весь код располагается внутри серверной формы. Также обратите внимание на
то, что при создании нового списка рассылки задание его имени является необхо-
димым, ЧТО Обеспечивается управляющим элементом RequiredFieldValidator. На-
значение свойства controiTovaiidate (управляющий элемент, подлежащий проверке)
очевидно, а свойство Display, которому присваивается значение dynamic, означает,
что область для сообщения об ошибке будет выделяться в динамическом режиме.
Одним из наиболее интересных серверных управляющих элементов является
элемент табличного вывода, который в нашем приложении используется для выво-
да списков рассылки. Этот управляющий элемент обладает широким спектром
функциональных возможностей, для использования которых требуется всего лишь
несколько строк кода: отличающиеся стили для подлежащих изменению строк,
сортировка данных и постраничное разбиение данных. Однако наиболее важным
представляется то, что этот управляющий элемент является полностью настраива-
емым и основанным на использовании шаблонов. С помощью программного шаб-
лона можно определить содержимое каждого столбца и указать способ, которым
эти данные должны выводиться.
Именно здесь задаются свойства управляющего элемента для табличного выво-
да данных:
CssClass="Grid_General"
HeaderStyle~CssClass=HGrid_HeaderH
ItemStyle-CssClass="Grid_Item"
AlternatingItemStyle~CssClass="Grid_AlternatingItein"
' Ai lowSort ing-11 True"
: AutoGeneratedColumns^"False"
DataKeyField="ID"
OnEditCornmand="ListsGrid_Edit"
OnCancelCommand="ListsGrid_CancelEditu
OnUpdateCoramand="ListsGrid_Update"
OnDeleteCommand="ListsGrid_Delete"
OnSortCommand="ListsGrid_SortM >
Задаются стили, которые будут использоваться при выводе различных состав-
ляющих таблицы, кроме того, мы определяем, что эти данные могут быть отсорти-
рованы, а также задаем столбец в исходной таблице, который будет использоваться
в качестве первичного ключа данных таблицы (свойство DataKeyFieid). В послед-
них строках описываются процедуры обработки событий, вызываемые для реали-
зации различных операций над таблицей.
Далее требуется объявить, каким образом будет представлен каждый столбец.
Нам необходимы следующие столбцы:
• Допускающий щелчок мышью рисунок для редактирования строки
• Допускающий нажатие мышью рисунок для удаления строки
• Столбец для вывода названия списка
• Столбец для вывода описания списка
816 Практический пример
• Допускающий щелчок мышью рисунок для перехода к странице,
где выводятся подписчики списка, который находится в текущей строке
• Допускающий щелчок мышью рисунок для перехода к странице,
на которой выводятся ранее отправленные сообщения
для данного списка
• Допускающий щелчок мышью рисунок для перехода к странице,
которая позволяет отправить новое сообщение по электронной почте
« всем подписчикам данного списка
Поскольку табличное представление данных до сих пор в книге не встречалось,
то мы подробно остановимся на его реализации. Ниже приводится код, необходи-
мый для вывода первых двух столбцов:
• • • • • • • • • • • . • • . . . :, .,•. < C o l u m n s > ' ' : • , . . • • • • . • • . • . . . • . • : • • • • • . • • • . . • • . • . . • • . • • '• • ^
ItemStyle-Width="25px"
EditText="src=./Images/imgEdit.gif>"
CancelText="UpdateText="/ > • Л ^ • : • ,
ItemStyle~Width="25px"
Text="• . •';.,. , ' src=. / I m a g e s / i m g D e l e t e . g i f > " •••• • ""''" .'• '
СommahdName="de1ete"
EditcoiumnButton — это особый столбец, содержащий ссылку на начало редак-
тирования, a Buttoncolumn позволяет создавать обычные кнопки или ссылки. Для
выполнения любой операции, которая может потребоваться, необходимо обраба-
тывать событие click. Обратите внимание на то, что для представления кнопок
свойство столбца Text задается с помощью тега обычную строку вместо этой HTML-строки, то мы получаем стандартную кнопку
с надписью в виде этой строки.
Ниже приводится программа для вывода столбцов, содержащих поля списка ID,
Name И Description!
itemStyle-Width="l£opx"
Text-^<%# DataBinder.Eval (Container. Dataltem, "Name") %>.'
Class="TextBox"
Width="150px11
ControlToValidate="EditListName"
Display="dynamic">* Name is required
Практический пример 2 — Менеджер рассылки новостей в режиме онлайн 817
• SortExpression="Description">
Text='<%# DataBinder.Eval (Container.Dataltern,
"Description") %>'
: Class="TextBox"
Width=n380px"
/ > • . . . ' • • ••
Первый столбец описывается в этой программе как обычный, не подлежащий
редактированию столбец. Два других столбца позволяют продемонстрировать, ка-
ким образом по шаблону можно создавать столбец, использующий управляющий
элемент Label для вывода значения или управляющий элемент TextBox для его ре-
дактирования. Соответствующее представление создается автоматически, когда мы
входим в режим редактирования для данной строки или покидаем его. Обратите
вниманиела то, что текст в управляющем элементе Label и в управляющих эле-
ментах TextBox обрабатывается С ПОМОЩЬЮ метода DataBinder.Eval (), который
возвращает значение соответствующего столбца для считываемой строки, а для
добавления нового списка требуется задать его имя.
Три остальных столбца представляют собой ссылки, которые позволяют пере-
ходить на страницы с дополнительной информацией:
DataNavigateUrlField=HID"
: DataNavigateUrlFormatStrings"Subscribers.aspx?ListID={0}"
: DataTextFormatString="src=./Images/in\gAddresses.gif >"
DataTextField="ID"
/>
DataNavigateUrlField^ID" :
DataNavigateUrlFormatString:="NewsHistory.aspx?ListID={0}"
DataTextFormatString=Hthis list' :s.rc=. /Images/imgMessage.gif>"
DataTextField="IDM
; •. / > • • • ; : ^ : v V / r : .v. " ^ i ^ •^•.••:-'-: V / ' ' ' •'• " " ' ,'.' ' :\
DataNavigateUrlField="ID"
DataNavi&ateUrlFonnatString-"SendEmail;aspx?ListID={d}"
DataTextFormatString=nfor this list' src=./Images/imgMail.gif>"
DataTextField="ID" :
• : . /> ;•• . - ' • : • . : . ; ' :
Эти нередактируемые гиперссылки представляются в виде образов, а URL-адреса,
на которые они указывают, создаются с помощью шаблона строки, описываемого
в DataNavigateUriFormatstring: вместо маркера {0} вставляется ID соответствую-
щей строки.
Класс BasePage
Прежде чем приступить к изучению файла Lists.cs с кодом поддержки, о кото-
ром упоминалось в предыдущем разделе, представим базовый класс, который бу-
дет использоваться всеми классами из файлов с кодом поддержки, используемыми
818 Практический пример
в этом примере. Этот класс называется BasePage, и он является производным от
класса System.web.ui.Page. Его описание сведено в следующую таблицу:
Класс BasePage
Метод Описание
public string GetConnString () Извлекает строку соединения с базой данных
из файла web.config — файла, в котором хранятся
все установки конфигурации данного приложения
public string GetSettingsFile () Извлекает имя файла, в котором хранятся все установки
данного приложения, также находящегося в файле web.config
Этот класс обладает двумя общими методами, которые наследуются всеми про-
изводными классами. Это пример правильного использования объектно-ориенти-
рованного подхода, поскольку строка соединения и имя файла с установками могут
понадобиться ддя всех этих классов, и наилучшим решением будет поместить функ-
циональную возможность доступа к этой информации в одном классе, вместо того
чтобы копировать и переносить ее каждый раз, когда у какого-либо класса возни-
кает в ней необходимость. Обе функции реализованы весьма простым способом —
они осуществляют поиск строки соединения и имени файла с установками в приве-
денном ниже разделе файла web.config, после чего помещают эту информацию
в кэш-память:
: Необходимо изменить вышеупомянутый ключ connstring так, чтобы он правиль-
но указывал на файл базы данных.
Код поддержки для Lists, aspx
После определения базового класса перейдем к рассмотрению того, что нахо-
дится в файл^е Lists.aspx с кодом поддержки.
Класс Lists
В СПИСКе ДИреКТИВ using ЭТОТ КЛаСС наХОДИТСЯ В Пространстве Имен NewsMailer
И является ПРОИЗВОДНЫМ ОТ BasePage:
namespace MewsMailer
{
public class Lists : MewsMailer.BasePage
После объявления нескольких защищенных управляющих элементов Web Form,
мы подходим к тому месту, где реализованы функциональные возможности страни-
цы. Ниже приводится обработчик, который запускается при загрузке страницы:
. protected void Page_Load(object sender, EventArgs e)
Щ Ш / - ' ' '{ ' ' ' : ; ' : \ V " : ' ;' •;;••;•."'."••. ••", ' _ -."••. х / Г / Т Ч ^ : ••.•;•;•;•;' •:• : V . . ; : : у - .-;._•:;;.
if (IPage.IsPostBack)
— 819
метод BindGrido, который наполняет таб-
protected void BindGrid ()
Datavicw myDV = lists.GetLists(,.TablestO].Defaultview;
2 «
ListGrid.DataSource = myDV;
Ust.Grid.DataBindO;
вторного запроса к базе данных
Н.„ .
вд» -
в „о„е„т „ерв о г о
данные вообще не
для вывода строк.
Сортировка списков
ShowAddNewControls{false);
bistsGrid.Editltemlndex = -l;
s —
о т п Р а в к и но-
в ы в о д и и ы е
выводимые
и вызывается метод
820 Практический пример
.11 установить атрибут SortExpression, который будет использоваться
//для сортировки данных в методе -BindGr id
ListsGrid.Attributes["SortExpression}=e.SortExpression.ToString{);
BindGrid();
} -. -.-. • ; Ш :--ъ
Прежде всего эта функция прячет управляющие элементы для включения нового
списка, если они видимы в данный момент. Затем она отменяет режим редактиро-
вания строки, если он был. установлен. Наконец, она получает выражение сорти-
ровки, по которому будет осуществляться фактическая сортировка, и название
столбца, а затем обновляет содержимое управляющего элемента табличного пред-
ставления данных, вызывая метод BindGr id ().

Практический пример 2 - Менеджер рассылки новостей в режиме онлайн

basic — Wed, 10 Feb 2010 21:59:12 GMT

Практический пример 2 -
Менеджер рассылки новостей
в режиме онлайн
Программа рассылки новостей
В предшествующих главах настоящей книги вы познакомились с тем, как про-
граммировать на языке С# и как использовать этот язык программирования
в приложениях Windows и простых приложениях ASP.NET. Теперь мы собираемся
продемонстрировать, каким образом можно использовать многое из того, с чем вы
познакомились, для создания web-приложения, которое может быть использовано
в реальном web-сайте .NET.
Ниже перечислены некоторые из тем, с которыми вы познакомитесь или кото-
рые вы сможете лучше усвоить в результате прочтения этого практического при-
мера:
• Создание законченных web-приложений с помощью ASP.NET
• Использование некоторых серверных управляющих элементов ASP.NET
для создания пользовательского интерфейса с богатыми возможностями
• Использование кода поддержки для разделения основного кода
от пользовательского интерфейса
• Создание файла web-конфигурации для хранения установок пользователя
для данного приложения и для обеспечения безопасности
базового уровня
• Использование объектно-ориентированных возможностей С#
для создания и применения классов, в которых инкапсулирована
бизнес-логика приложения -
• Использование некоторых классов .NET Framework
для работы с файлами, почтой и базами данных
• Запись в базу данных и чтение из базы данных с помощью
управляемого провайдера OLE DB и классов ADO.NET
• Распространение компилированных приложений ASP.NET
и их запуск через IIS
796 Практический пример
Общий обзор приложения
Любому web-мастеру известны ключевые элементы, необходимые для разра-
ботки успешного web-сайта. Вот некоторые из них:
• Хорошее наполнение (контент)
• Организация (удобство поиска и навигации)
• Привлекательный дизайн
• Взаимодействие с пользователем
Успешный web-сайт должен обладать свежим, регулярно обновляемым и инте-
ресным содержимым. Список адресов электронной почты может оказаться весьма
полезным для постоянного уведомления подписчиков о новых возможностях —
в качестве напоминания посетителям и стимула для регулярного посещения сайта.
Управление таким списком может представлять определенные трудности. Адми-
нистраторам приходится сопровождать список подписчиков, иметь дело с заявками
на подписку и с отказами от подписки, а также отслеживать все отправленные со-
общения.
Приложение, представляемое в настоящей главе, сможет оказать помощь в ав-
томатизации управления одним из таких списков. Эта программа — Менеджер
рассылки новостей в режиме онлайн — позволяет автоматизировать большую часть
задач, связанных с подпиской и управлением рассылкой новостей, а также упрос-
тить выполнение администратором остальных действий. Эта программа позволяет:
• Управлять множественными списками рассылок, давая администратору
возможность добавлять, исключать или вносить изменения
в списки и их свойства.
• Осуществлять управление подписчиками из всех списков
с возможностью задавать и изменять имя подписчика
и относящуюся к нему персональную информацию.
• Рассылать подписчикам сообщения по электронной почте в виде
обычного текста или в HTML-формате. Все электронные сообщения
могут автоматически снабжаться именем и адресом подписчика,
содержать ссылку, позволяющую произвести отказ от подписки,
а также любую другую информацию о списке (например, его название
. и описание).
• Управлять архивом новостей, рассылавшихся по всем спискам ранее,
предоставляя администратору возможность читать и копировать
предыдущие сообщения.
• Создавать HTML-форму, позволяющую получать данные пользователя
без необходимости писать какой бы то ни было код. Эта функциональная
возможность оформлена в виде программы-мастера — администратор
выбирает список, для которого ему требуется создать форму, задает
несколько опций, после чего мастер самостоятельно создает
весь необходимый код.
• Задавать некоторые опции, например, имя и адрес отправителя, подпись,
которая будет автоматически добавляться к каждому сообщению,
предмет сообщения по умолчанию, а также сообщения о подписке
и об отказе от подписки.
Практический пример 2 — Менеджер рассылки новостей в режиме онлайн 797
• Использовать возможность изменения внешнего представления
приложения (цвета и размеры шрифтов) без внесения изменения
в HTML-код или загрузки новых файлов.
Самым существенным преимуществом такого решения является то, что больше
не придется вручную управлять группой пользователей: приложение добавляет их
в базу данных и исключает их оттуда. Вторым, и также важным преимуществом
является то, что администратор получает возможность следить за подписчиками
web-сайта в режиме онлайн, общаться с ними и даже вносить изменения во внеш-
нее представление web-сайта из любой точки планеты. Все, что ему для этого тре-
буется,— это компьютер с web-браузером и выход в Интернет.
В данном примере предполагается, что для разработки приложения
вы будете использовать Visual Studio.NET. Если это не такг то в программе,
которую вы можете загрузить, содержатся указания как откомпилировать
это приложение из командной строки.
Модель приложения
Хорошие приложения, построенные на основе использования баз данных,
обычно разбиваются на уровни для представления, бизнес-логики и данных. Такая
модель упрощает сопровождение приложения, а также дает лучшую масштабируе-
мость, поскольку допускает установку приложения на различных серверах. Даже
если приложение, которое мы собираемся разрабатывать, не требует повышенной
масштабируемости, все равно это тот путь, по которому следует двигаться. Графи-
ческое представление структуры нашего приложения представлено на следующей
диаграмме:
Службы пользователя
Страницы ASP.NET
• -• t Ь - ' • : • • • ' : • ' • • ' • '
Т '. - . ' • • -'•• - : ': •'
Классы кода поддержки
(NewsMailer.dll)
/
/
Бизнес-службы
/
/
Модуль доступа
к базе данных
(NewsMailerDB.dll)
Модуль менеджера
конфигурации приложения
(NewsMailerConfig.dll)
Службы данных
Доступ к базе данных
(NewsMailer.mdb)
Файл конфигурации
(NewsMailer. Settings)
Уровень представления (службы пользователя) состоит из страниц ASP.NET
с их кодом поддержки (откомпилированным в модуль). Уровень бизнес-служб со-
держит в себе еще два модуля, которые обеспечивают простой доступ к данным.
Настоящий раздел посвящен подробному объяснению реализации каждого из этих
уровней и модулей.
798 Практический пример
Объекты данных и бизнес-объекты
NLesiwtsDsMBaelirDB.dl (ListsDB.cs)
(SuSbusbcsrcbibreiersrsDDBB.es)
—(NNewewsHsHsitsoitoryryDDBB.es)
NewsMailerConfig.dl
AAppppSCeotntinggfis
(AppConfig.es)
Мы начнем обсуждение с уровня данных
и бизнес-уровня. На диаграмме, приведенной
на рисунке слева, показаны два модуля бизнес-
уровня и общие классы, входящие в их состав.
Модуль NewsMaiierDB.dll обеспечивает до-
ступ к базе данных, в нем хранятся названия
списков рассылки, подписчики и предыдущие
Сообщения. Модуль NewsMailerConfig.dll
обеспечивает доступ к XML-файлу, в котором
хранятся установки и где все опции приложе-
ния могут считываться и изменяться.
Модель базы данных
В целом приложение основывается на использовании базы данных, поэтому
начнем обсуждение проекта с выбора и обсуждения модели базы данных. Мы ре-
шили использовать базу данных Access вместо SQL Server по целому ряду причин.
Базу данных Access проще конфигурировать, кроме того, ее наличие предусматри-
вается в большинстве планов по работе с web-серверами, в то время как наличие
SQL Server предусматривается только в наиболее сложных (и более дорогих) про-
ектах по использованию web-серверов. Кроме того, поскольку выигрыш от исполь-
зования менеджера рассылки новостей прежде всего получают небольшие web-
сайты, мы предпочли написать приложение, которое может быть использовано
всеми. Более того, использование SQL Server оправдано для широкомасштабных
сайтов, при обращении к которым многим пользователям одновременно требуется
установление соединения с базой данных. В нашем приложении регулярно уста-
навливать соединение с базой данных будет только администратор. Пользователям
потребуется соединение только для подписки или отказа от подписки, однако тако-
го рода операций выполняются очень быстро, и представляется маловероятным,
что очень большое количество пользователей решит подписаться одновременно.
Поэтому если вам не приходится работать с десятками тысяч подписчиков, база
данных Access является более адекватной. Тем не менее, по ходу обсуждения будет
сделано несколько кратких замечаний, как можно перенести базу данных на SQL
Server, чтобы воспользоваться ее мощью и скоростью. Совершенно очевидно, что
если некоторые части сайта уже используют базу данных SQL Server (например,
при разработке сайта электронной коммерции и использовании SQL Server для
хранения наименований продукции
и информации о ней), вам следует ин-
тегрировать в нее и менеджера рас-
сылки новостей, и все таблицы, с тем
чтобы избежать использования двух
разных баз данных.
Перейдем к обсуждению модели
базы данных. БД состоит из четырех
таблиц, которые связаны между собой
отношениями, изображенными на ри-
сунке справа.
Теперь мы переходим к подробному
описанию этих таблиц и их отношений.
Практический пример 2 — Менеджер рассылки новостей в режиме онлайн 799
Таблица Lists
Таблица Lists используется для хранения информации обо всех доступных спи-
сках рассылки и имеет следующую структуру:
Название
столбца
ID
Name
Description
Тип
AutoNumber
Text
Text
Размер
50
250
Допускается
значение null
Нет
Нет
Да
Описание
Уникальный идентификатор списка
рассылки
Имя списка рассылки
Необязательное описание списка
рассылки
Таблица UsersData
В таблице UsersData хранится персональная информация пользователей. Таб-
лица имеет следующую структуру:
Название
столбца Тип Размер
Допускается
значение null Описание
ID AutoNumber Нет
FirstName
LastName
Email
Text
Text
Text
50
50
50
Нет
Нет
Нет
Уникальный идентификатор
пользователя
Имя пользователя
Фамилия пользователя
Адрес электронной почты
пользователя
В данной таблице не содержится указания на то, к какому списку рассылки
приписан пользователь, поскольку один пользователь может подписаться сразу на
несколько различных списков. Наилучшая практика — избегать повторения одних
и тех же деталей. К этому мы вынуждены были бы прибегнуть, если бы решили
хранить подробную информацию о пользователях вместе с каждым из списков, на
которые они подписались. Размещение данных о пользователях в виде отдельной
таблицы позволяет не тратить места впустую, а если возникнет необходимость из-
менить какую-либо информацию о пользователе (скажем, при изменении адреса
электронной почты), то потребуется обновить только единственную запись для
всех списков рассылки, на которые этот пользователь подписан.
Таблица Subscribers
Таблица Subscribers в основном используется для хранения связей между спи-
ском и пользователем. В ней также хранится дата, когда пользователь первый раз
подписался на этот список. Данная таблица имеет следующую структуру:
Название
столбца Тип Размер
Допускается
значение null Описание
ID
ListID
AutoNumber
Integer
Нет
Нет
Уникальный идентификатор подписки
Идентификатор списка, на который
подписался пользователь
800
Название
столбца Тип Размер
Допускается
значение null
Практический пример
Продолжение таблицы
Описание
UserID
CreateDate
Integer
Date
Нет
Нет
Идентификатор пользователя,
который должен совпадать
с идентификатором пользователя
в таблице UserDataTable
Дата создания данной подписки
Таблица NewsHistory
Таблица NewsHistory используется для хранения предыдущих сообщений, от-
правленных подписчикам всех рассылочных списков, и имеет такую структуру:
Название
столбца Тип Размер
Допускается
значение null Описание
ID
ListID
Subject
Body
IsHTML
AutoNumber
Text
Text
Memo
Boolean
200
SentDate Date
Нет
Нет
Нет
Да
Нет
Нет
Уникальный идентификатор сообщения
Название списка рассылки, в соответствии
с которым рассылалось данное сообщение
Предмет сообщения
Тело сообщения
Если значение равно true, это означает,
что сообщение отправлялось
в HTML-формате
Дата отправки сообщения
Отношения между таблицами
Если вернуться немного назад и взглянуть на рисунок, на котором представле-
ны отношения между таблицами, то можно увидеть, что между таблицами Lists
И Subscribers И L i s t s И NewsHistory Существует отношение ОДИН КО МНОГИМ, так
как каждый список может иметь несколько подписчиков и несколько отправлен-
ных ранее сообщений. Аналогичным образом, один пользователь может подписать-
ся более чем на один список, поэтому отношение между таблицами usersData
и subscribers — также один ко многим.
Задать отношения между таблицами с помощью Access очень просто. Пройдем
эту процедуру последовательно, шаг за шагом. Откройте файл NewsMaiier.mdb
и выберите пункт меню Tools | Relations. Появится диалоговое окно, в котором на
переднем плане изображены четыре используемые таблицы, а на заднем — пустое
окно. Последовательно выберите и добавьте в это окно одну за другой все таблицы,
изображенные в первом диалоге, после чего закройте окно. Теперь в окне, которое
изображалось на заднем плане, выводятся все четыре таблицы, и можно присту-
пать к созданию отношений между ними. Сначала нужно привязать к таблице Lists
таблицу Subscribers. Щелкните мышью на поле ListiD таблицы subscribers, пе-
ренесите его в поле ID таблицы Lists и отпустите. Это приведет к появлению диа-
логового окна, изображенного на рисунке на стр. 801.
Два раскрывающихся списка в этом диалоговом окне позволяют выбирать
поля, между которыми устанавливаются отношения. Если была проведена опера-
ция переноса мышью, то необходимые поля уже являются выбранными, а описание,
Практический пример 2 — Менеджер рассылки новостей в режиме онлайн 801
ID
шдо
Subject
•siBrtTodMyL
3
a n s r .
• Г C«c*de Update Rel-зЫ Field* •
(7 Cascade Dd<*« Rented Records
J • 1
расположенное в нижней части диалога, гласит
"один ко многим", что означает, что один список
рассылки предназначается для множества под-
писчиков. Вместо операции переноса мышью
можно было щелкнуть мышью два раза на
основном окне (с таблицами), что привело бы
к переходу в то же диалоговое окно, но только
без наличия выбранных полей таблиц, между
которыми устанавливаются связи.
Прежде чем окончательно создать отношение,
требуется учесть еще один момент: необходи-
мость установки Referenda! Integrity (ссылочная
целостность) и включения Cascade Delete (кас-
кадное удаление), как это показано на рисунке.
Поступив таким образом, мы добьемся того, что
при удалении некоторого списка привязанные
к нему подписчики также будут автоматически
удалены. Есть еще опция Cascade Update (кас-
кадное обновление), которая гарантирует, что
все значения ListiD в таблице subscribers бу-
дут обновляться при изменении значений ID
в таблице Lists, однако нам такой режим не
требуется, поскольку поле ID имеет значение
типа AutoNumber, которое не может изменяться
после включения записи в таблицу.
Теперь нам следует создать отношения между таблицами Lists— NewsHistory
и subscribers—usersData аналогичным образом, определяя, между какими полями
должны быть установлены связи с помощью вышеприведенного рисунка.
Бизнес-классы, предназначенные
для доступа в базе данных
Код, который осуществляет работу с базами данных, логически и физически по-
дразделяется на несколько различных классов. Все эти классы будут откомпилиро-
ваны в библиотеку классов с именем NewsMaiierDB. Остальная часть кода —
классы кода поддержки приложения — будет помещена в отдельный модуль. Это
наилучший подход, ибо, если возникает необходимость внести какие-либо измене-
ния в работу базы данных или требуется установить новую версию SQL Server, для
этого будет нужно внести изменения и повторно откомпилировать только бизнес-
модуль. Это лучше, чем компилировать все вместе (бизнес-классы и класс под-
держки) в единый модуль, поскольку можно использовать бизнес-модуль само-
стоятельно, например, в клиентской части приложения Windows.
Для данного приложения такой подход не дает существенных преимуществ;
структура приложения является довольно простой, компилировать приходится не
такие уж большие файлы, и никакие другие клиенты эти бизнес-классы не исполь-
зуют. Поэтому, даже если мы все откомпилируем в единую DLL, это не приведет
к серьезным проблемам. Но мы будем использовать отдельные DLL-модули, для
того чтобы продемонстрировать, насколько все это просто, и для того, чтобы при-
учить вас к хорошим манерам
802 Практический пример
Если вы разрабатываете проект с нуля, вы должны посвятить все время, затра-
ченное на создание проекта, объектно-ориентированной разработке, для чего
обычно следует отделить бизнес-классы от кода пользовательского интерфейса
и компилировать их в разные библиотеки. Разбиение кода на несколько отдельных
модулей может быть осуществлено и позднее, поскольку это относится к процедуре
компиляции. Однако при этом необходимо создавать такие классы, единственная
задача которых — осуществлять взаимодействие с базой данных, размещая весь
код, ответственный за пользовательский интерфейс, в других классах.
Создание проекта
Если для разработки используется Visual Studio.NET, то следует создать новый
проект с типом С# | Class Library и назвать его NewsMaiierDB. Затем необходимо
приступить к созданию файлов классов для данного модуля, что будет объясняться
в следующих разделах. Необходимо создать новый файл для каждого класса с по-
мощью команды Project | Add New Class, либо с помощью Project | Add Existing Item,
если вы пожелаете импортировать готовые файлы с web-сайта издательства Wrox.
Обратите внимание на то, что код этих бизнес-классов воспроизводится
в тексте книги.
Класс ListsDB
Класс ListsDB предоставляет все функциональные возможности, необходимые
как для выполнения манипуляций над уже существующими списками рассылки, так
и для создания новых. Информация об этом классе сведена в следующую таблицу:
Класс ListsDB
Метод Описание
public ListsDB (string ConnString)
public DataSet GetListsO
public DataRow GetDetails(int ListID)
public bool Add (string ListName,
string listDescr)
public bool Delete (int ListID)
bool Update (int ListID, string ListName,
string listDescr)
Конструктор класса, которому в качестве параметра
передается строка соединения, описываемая в установках
файла (к их обсуждению мы перейдем позже)
Возвращает объект DataSet, в котором содержатся
все доступные списки новостей
Позволяет получать подробную информацию о списке
по заданному идентификатору
Добавляет новый список с заданным именем и описанием
Удаляет указанный список
Позволяет изменять свойства Name и Description
указанного списка
Метод GetListsO возвращает набор данных, в котором находится все содержи-
мое таблицы Lists, то есть все доступные списки и их свойства. Этот метод воз-
вращает единственный список, который задается идентификатором, передаваемым
методу в качестве параметра.
С помощью метода Delete о можно удалить запись с идентификатором, преда-
ваемым этому методу в качестве параметра. Почти так же работают методы Add о
и update о за исключением того, что параметры могут содержать еще и данные,
которые должны быть модифицированы или добавлены.
Практический пример 2 — Менеджер рассылки новостей в режиме онлайн 803
Класс SiibscribersDB
Класс SubscribersDB предназначается для доступа к таблицам subscribers
и usersData. Он обладает структурой, аналогичной структуре класса ListsDB,
и хранится в файле subscribers.cs. Все методы этого класса сведены в следую-
щую таблицу: s
Класс Subscribers
ЭВМетод Описание
public SubscribersDB (string ConnString)
public DataSet GetSubscribers(int ListID)
public DataRow GetDetails(int SubscrlD)
public bool Add(int ListID, string FirstName,
string LastName, string Email)
public bool Delete (int SubscrlD)
public bool Update (int SubscrlD, string FirstName,
string LastName, string Email)
public int GetUserID(int SubscrlD)
public int GetUserID(string Email)
public int GetSubscriberID(int ListID,
string Email)
Конструктор класса, которому в качестве
параметра передается строка соединения,
описываемая в установках файла
Возвращает список подписчиков данного списка
Позволяет получать подробную информацию
о списке по заданному идентификатору
Добавляет нового подписчика
Удаляет подписчика
Позволяет обновить подробную персональную
информацию о подписчике
Возвращает идентификатор пользователя
по заданному идентификатору подписки
Возвращает идентификатор пользователя
по заданному адресу электронной почты
Возвращает идентификатор подписчика
для конкретного списка и конкретного
пользователя, определяемый по уникальному
адресу электронной почты
Этот класс оказывается несколько более сложным, чем класс ListsDB, поскольку
ему приходится иметь дело с двумя таблицами и управлять отношениями между
ними. Функция GetSubscribers о возвращает всех подписчиков того списка, иден-
тификатор которого передан ему в качестве параметра. В нем используется
SQL-оператор, в котором содержится команда INNER JOIN, позволяющая получать
информацию сразу ИЗ двух таблиц — UsersData И Subscribers!
public DataSet GetSubsctibers (int ListID)
string sqlCmd = "SELECT FirstName, LastName, Email, ";
sqlCmd += "ListID, UserlD, CreatedDate, Subsctibers.ID FROM UsersData ";
sqlCmd += "INNER JOIN Subscribers ON UsersData.ID= Subsctibers.UserlD ";
sqlCmd += "WHERE Subscribers.ListID = * + ListID;
DataSet subsctibers = new DataSet();
OleDbConnection myConn = new OleDbConnection(connString) ;
OleDbDataAdapter myDAdp = new OleDbDataAdapter (sqlCmd, myConn) ;
myDAdp.Fill(subscribers, "Subscribers*);
return subscribers;
Метод GetDetaiisO практически полностью аналогичен соответствующему ме-
тоду класса ListsDB; отличие заключается в SQL-строке, которая у него такая же,
как приведенная выше.
804 Практический пример
МеТОДЫ Add(), D e l e t e () И Update () ПОЗВОЛЯЮТ ВСТаВЛЯТЬ, удаЛЯТЬ И МОДИфиЦИ-
ровать подписку пользователей в новые списки. Они выполняют эту работу не-
сколько по-другому, чем соответствующие методы класса ListsDB. Функция
Delete о сначала удаляет подписчика из указанного списка, а затем производит
проверку, включен ли данный пользователь в какие-либо другие списки. Если нет,
то информация о пользователе удаляется из таблицы usersData. Функция Add о не
только добавляет подписчика в указанный список, но и проверяет, не совпадает ли
переданный ей адрес электронной почты с каким-либо адресом, уже имеющимся
в таблице UsersData. Если нет, то делается предположение, что это новый пользо-
ватель, и он добавляется в таблицу. Для создаваемого приложения мы будем исхо-
дить из предположения, что каждое вхождение поля электронной почты представляет
уникального пользователя.
Далее приведены две перезагрузки метода GetuseriDO, которые предназнача-
ются для внутреннего использования методами Delete о и Add(). Первый вариант
принимает в качестве параметра идентификатор подписчика и возвращает иденти-
фикатор пользователя, привязанный к данной подписке; этот метод используется
внутри метода Delete (). Вторая перезагрузка принимает в качестве параметра
строку адреса электронной почты и возвращает идентификатор пользователя, при-
вязанный к данному адресу, если таковой существует; этот метод используется
внутри метода Add ().
Последняя функция данного класса — GetSubscriberiDO — возвращает иден-
тификатор подписчика определенного списка по указанному адресу электронной
почты. Эта функция используется методом Add(), чтобы определить, существует
ли уже пользователь, который осуществляет подписку на данный список, в табли-
це UsersData, ИЛИ нет.
Класс NewsHistoryDB
КлаСС NewsHistoryDB (который Хранится В файле NewsMailerDB.cs) ЯВЛЯеТСЯ
самым простым из всех; он состоит всего лишь из четырех методов и параметризо-
ванного конструктора метода, как показано в приведенной ниже таблице:
Класс NewsHistoryDB
Метод Описание
public NewsHistoryDB (string ConnString) Конструктор класса, которому в качестве параметра
передается строка соединения, которая описывается
в установках файла
public DataSet GetNews(int ListiD) Возвращает все наименования новостей
для указанного списка
public DataRow GetDetails (int NewslD) Позволяет получать строку, которая идентифицирует
указанную запись News
public bool Add (int List ID, string Subject, Добавляет подробную информацию о записи
string Body/ bool isHTML) c новостями в заданный список
public bool Delete (int NewslD) Удаляет указанную запись News
Компиляция модуля
Когда создание всех файлов завершено, можно откомпилировать модуль. Если
вы выполняли все действия в Visual Studio.NET, то ваш Solution Explorer должен
принять вид, изображенный на рисунке на стр. 805.
Практический пример 2 — Менеджер рассылки новостей в режиме онлайн 805
Solution EKpforer ~ NewsMaifet
' э
r*(I project)
й-
ЕЬ Й References
§1) AssernblyInfoDB.es
§g| ListsDB.cs
«3] NewsHistoryDB.es
|8] SubscribersDB.es
soiu- 1 Class Vii
Файл Assembiyinfo.es содержит множество всех атрибутов,
которые транслируются в модуль наряду с исходными файлами.
Этот файл создается Visual Studio.NET по умолчанию в момент
создания проекта. Мы не будем вносить в него какие бы то ни
было изменения. •
При этом в режиме Class
View должна выводиться
картинка, представленная на
рисунке справа.
Компиляция модуля за-
ключается в использовании
команды Build в VS.NET.
* 4 t >

Управление опросами

basic — Wed, 10 Feb 2010 21:58:24 GMT

Управление опросами
Одно из преимуществ .NET перед предшествующими технологиями заключает-
ся в том, что возможность повторного использования создаваемого программного
обеспечения несколько упрощается. В этом разделе мы собираемся создать пакет
web-сайта для проведения опросов, с тем чтобы иметь возможность вставлять
этот сайт в любую страницу ASP.NET при помощи всего лишь пары строк кода.
На данном этапе необходимо выполнить довольно значительный объем работы,
для того чтобы интегрировать процедуру проведения опроса в какую-либо другую
web-страницу, поскольку для этого потребуется скопировать соответствующую ин-
формацию как из файла с расширением .aspx, так и из файла "с кодом поддерж-
ки", который имеет расширение .aspx.cs. Мы будем создавать управляющий
элемент таким образом, что в качестве дополнительной возможности он будет вы-
водить страницу с опросом, и если данный пользователь уже проголосовал ранее,
он сможет только ознакомиться с результа-
тами опроса — страница голосования выво-
диться не будет.
Для того чтобы создать пакет для прове-
дения голосования, нужно разработать не-
стандартный управляющий элемент, который
будет реализован в классе, наследуемом от
класса control, описанного в .NET Framework.
Для начала в Visual Studio.NET следует
щелкнуть правой кнопкой мыши на проекте
web-приложения (poiiw), выбрать меню Add,
а в нем пункт Add New Item. В появившемся
диалоговом окне нужно выбрать иконку
Web Custom Control и ввести в поле Name
Poiicontroi.cs, как это проиллюстрировано
на рисунке слева.
Хотя Visual Studio.NET генерирует несколько строк кода, для того чтобы нам
было с чего начинать (при этом реализуется свойство Text создаваемого управля-
ющего элемента), однако нам все это не понадобится, поэтому для начала работы
нужно привести класс к еще более простому виду:
using System;
using System,Web.UI;
using System.Web.Ul.WebControls;
using System.ComponentModel;
namespace PollW
III /// Краткое описание класса PollControl.
/// public class PollControl : WebGontrol
{ ' .• . ... •• •• •• • •••. . • • • . • ' • - • • - • ; • . . .. • . , . • . , '
protected override void Render(KtmlTextWriter output)
output.Write("This is my Poll Control");
: / Это управляющий элемент для проведения опросов /
»J
Л ck*s :ot --testae, an ASP-KET server Cancel
Практический пример 1 — юеЪ-сайт для проведения опросов 791
Заметьте, что все, что на самом деле необходимо выполнить,— это создать
класс, который наследуется от System.web.ui.webcontrois.webcontroi. Сделав
это, мы реализуем переопределение метода Render о , в котором генерируем
HTML, который мы планируем выводить. Существует также возможность напи-
сать такой управляющий элемент, который будет создавать себя сам посредством
объединения других управляющих элементов, но в настоящем примере мы будем
генерировать HTML.
IS
H
Web Service
Component
•MS
Web User
Control
Data fotm
Wizard
Class
Data Set
HTML Рг$е
zi
•: j defaults. a$px
Попытаемся вставить в страницу
простой нестандартный управляющий
элемент и посмотреть, что для этого
придется сделать. Во-первых, добавим
к нашему проекту новую страницу,
КОТОруЮ назовем default2.aspx И КО-
торую мы будем использовать в ка-
честве контейнера нестандартного
управляющего элемента. Это дости-
гается за счет использования пункта
Add Web Form из меню Project, как
показано на рисунке слева.
Мы приведем в порядок содержи-
мое default2.aspx, чтобы ничего не
усложнять и четко представлять себе,
что происходит:
<%@ Page language="c#" Codebehind= default2.aspx.es" %>
. •.-.; . < h e a d > . . * . . : •: ;
< / h e a d > •,•••• . • • . : . • . ; . • • . ' : ; •/•• .:• . : • • • • . , . : • • : ' ' - ' : :-. .' • ... . .
• •'• ' ; • / • : : < b o d y > '' : ' :- • ' •' •'' ; . ' . ' • ; - .•• . ••• • '' : ^ ••••;/ . . . .
: : . ; . . ' < / b o d y > . •' '' •' '''.•• • • ' . . • ' • • ' . • . , • • • • ; • • . . • • • • - • • • • • : . . •
Для того чтобы вставить управляющий элемент для проведения опросов в стра-
ницу, следует добавить всего две строки:
<%@ Page language^1 с#" Codebehind= default2.aspx.es1' ......%>
<%@ Register TagPref ix="Wrox" Namespace="PollWn Assembly:=tlPollW11 %>
В первой из двух добавленных строк объявляется префикс тегов TagPrefix
с именем Wrox. Это означает, что если ASP.NET встречает на странице любой
серверный управляющий элемент, который начинается с нает осуществлять поиск в пространстве имен Poiiw в модуле Poiiw управляющего
элемента с таким же именем. В данном случае мы указали поэтому ASP.NET будет осуществлять поиск в пространстве имен Poiiw класса
Poiicontroi. Вторая добавленная строка представляет собой серверный управляю-
щий элемент, и именно в ней мы фактически вставляем опрос в страницу. Обратите
792 Практический пример
Fife Edit View Favorites Tools Help
Г Personal Bat ^Search 3j Favorites
-jhttp.7/localhost/poHw/defdulK2.aspx
This is my Poll Control
zl
внимание на то, что мы включили
в нее атрибут runat. Если же теперь
ОТКрЫТЬ файл def a u l t2 . aspx В Своем
браузере, то можно увидеть текст,
выводящийся методом Poiicontroi
Render () (см. рис. слева).
Мы успешно вставили в стра-
ницу нестандартный управляющий
элемент; теперь добавим в метод
Render о , находящийся в файле
Poiicontroi.cs, код, который по-
зволит выводить опрос на экран.
Упомянутый код оказывается практически идентичным коду для "файла поддерж-
ки" default.aspx.cs. He забудьте, что в начале файла необходимо поместить опе-
ратор using Polling:
protected override void Render(ЯtmlTextWriter output)
s t r i n g H t m l = * w ; • •'••;•••• . ' r ... .••••' y : .'.-.• • • • . ' • • : • • '•
Poll aPoll = Poll.Current();
Html += aPoll,Question + *
f or (int i=l'•; i<=aPoll. AnswerCount; i++}
I l o c e infc»
HtmlLink += *HtmlLink += "Scnbsp; * + aPol 1 Answers [i] + "
}
output.Write(Html);
fife £dfc View Favorites
Toosшl шHшeplшш
:avorites
.aspx jj 4^Sc i Links
Если теперь построить проект заново и открыть файл defauit2. aspx, то можно
увидеть то же самое, что и в случае default.aspx за исключением того, что эту
версию гораздо проще использовать повторно. Все, что необходимо сделать для
того чтобы использовать ее на некото-
ром сайте, — это сначала убедиться
в доступности файла vote.aspx, затем
убедиться в доступности модулей, со-
держащих классы Poll И PollControl,
после чего просто добавить две строки
кода к странице ASP.NET. В резуль-
тате этих действий получилась некая
оболочка, объемлющая отдельные
функциональные возможности. Мы
назвали ее управляющим web-элемен-
том. Этот подход позволяет объеди-
нять различные функциональные воз-
можности и облегчает их повторное
использование. Результат можно ви-
деть на рисунке справа.
What development language do you primarily use?
Vote C#
VoteC-H- . ,
Vote Java
Vote JavaScript
Vote Visual Bask
fe] Done trarjet A
Практический пример 1 — weh-caum для проведения опросов 793
Трехзвенность и приложение Poll
Уровень
представления
Уровень
бизнес-логики
Уровень
данных
Консольное
приложение
Приложение
Windows Forms
Web-службы
Класс Poll
C:\Polls.xml
Приложение
WebForm
Итоги
Нами создано приложение, которое может функционировать и как консольное
приложение, и как web-служба, и как приложение Windows Forms, и как Интернет-
интерфейс ASP.NET. Для того чтобы наглядно представлять себе, как все эти
отдельные части соотносятся друг с
другом, слева приведена диаграмма,
на которой изображены основные
элементы приложения Poll и проил-
люстрировано, каким образом это
приложение вписывается в модель
трехзвенной архитектуры, состоящую
из уровня данных, уровня бизнес-
логики и уровня представления.
Заметьте, что несмотря на то,
что приложение Windows Forms
обычно взаимодействует с классом
Poll посредством web-службы, ему не придется этого делать, если оно будет запу-
щено на той же машине, что и класс Poll (другими словами, на web-сервере).
Данный практический пример позволил продемонстрировать, каким образом
можно применить теорию по С# и .NET, изучавшуюся нами на протяжении всей
настоящей книги, в ситуации из реальной жизни, где перед нами возникла задача
создать приложение, которое было бы доступно посредством различных пользова-
тельских интерфейсов. В этом практическом примере воссоздается ситуация из
реальной жизни в том смысле, что мы на первой итерации создаем первоначаль-
ную версию приложения, а затем добавляем в него новые функциональные воз-
можности. В мире коммерческих продуктов программное обеспечение не пишется —
оно модифицируется, и именно это мы и попытались здесь продемонстрировать.
В качестве краткого напоминания перечислим приемы и технологии, которые
были использованы в этом практическом примере:
• Бизнес-объекты (класс Poll)
• Генерирование исключительных ситуаций
Q Нестандартный управляющий элемент ASP.NET
• Серверные управляющие элементы ASP.NET
• Статически методы класса
• Наборы данных XML и ADO.NET
• Web-службы и web-методы
• System.Timer (таймер)
• НТТР-куки
• Класс HttpContext
794 Практический пример
• Уровень представления, поддерживающий множество интерфейсов
• Консольное приложение
• Приложение Windows Forms
• Трехзвенная архитектура
• Объектно-ориентированная разработка
• Тестирование программного обеспечения
Надеемся, что вы получили удовольствие от чтения этой главы, а информация,
которую вы из нее почерпнули, вдохновит вас на создание своего собственного
приложения на С#. .NET в сочетании с такими методами, как трехзвенная архи-
тектура и объектно-ориентированная разработка, оказывается чрезвычайно мощ-
ной платформой для разработки программных приложений, а С# — наиболее
эффективным из всех языков программирования, входящих в состав .NET.

Пользовательский интерфейс (уровень представления)

basic — Wed, 10 Feb 2010 21:58:07 GMT

Пользовательский интерфейс (уровень представления)
Завершив создание уровня данных
и уровня бизнес-логики и поэксперимен-
тировав с консольным приложением на
уровне представления, можно перейти
к созданию web-интерфейса для опроса
с использованием ASP.NET. Прежде все-
го необходимо добавить проект ASP.NET
в наше решение в Visual Studio.NET.
Назовем его Poiiw (сокращение от Poll
Web), как показано на рисунке слева.
Заметьте, что при создании нового
web-приложения Visual Studio.NET авто-
матически генерирует несколько файлов,
ВКЛЮЧая файл WebForml. aspx — началь-
ную страницу ASP.NET. Переименуем ее
В default.aspx С тем, чтобы МОЖНО было
*"^Л' " ~С***'*
Project Types:
j l ' ----- С* Projects
CJ Seiyp -and Deployment Prefects
*" LJ Other Projects window
Application Windows
:i Шш
Щ
МС library
ASPJNE T Web w«b Ox*
_rJ
Location;
Project vM be created at hltp://locdhost/PofiW.
ссылаться на приложение следующим образом: https/ziocalhost/Pollw. У файла
default.aspx имеется привязанный к нему файл defauit.aspx.es с кодом под-
держки. Мы скоро приступим к работе с ним. Совершенно очевидно, что если
web-сервер выполняется не на вашей локальной машине, то необходимо указать
имя вашего сервера, а не использовать слово locaihost.
Но прежде необходимо подумать об одном важном моменте. Использование
ASP.NET позволяет создать фантастическую систему для построения web-форм,
которая во многом напоминает Visual Basic, поскольку в Visual Studio.NET можно
переносить управляющие элементы с помощью мыши и использовать программи-
рование, основанное на работе с событиями. Однако существует одна загвоздка —
при использовании ASP.NET можно использовать только одну форму на стороне
766 Практический пример
Г http://iocafhost/pollw/ - Micro
; File gdt View Favorites Tools Help
./ро?И
пользователя для каждой конкретной страницы. При создании web-сайта для про-
ведения опросов представляется логичным воспользоваться на стороне сервера
формой, которая будет обладать, например, одним переключателем для каждого
ответа и кнопкой Vote для регистрации сделанного выбора. Если остановиться на
таком подходе, то страница, на которой будет проводиться опрос, не сможет содер-
жать никаких других форм на стороне сервера, а если включить опрос на несколь-
ко страниц web-сайта, где впоследствии потребуется добавить еще какие-либо
формы (например, второй опрос или управляющий элемент поиска), то этого сде-
лать будет нельзя. Чтобы избежать проблем подобного рода, а заодно получить
возможность познакомиться с некоторыми не столь широко известными методами
.NET, нужно воспользоваться такой моделью web-сайта для проведения опросов,
в которой не будет использовано никаких форм на стороне сервера, т. е. перейти
не более низкий уровень возможностей ASP.NET, который может оказаться зна-
комым тем, программирует на ASP 3.0. И хотя использование этих возможностей
в ASP.NET является несколько необычным, все равно будет полезно познакомить-
ся с тем, как они работают в подобных ситуациях — когда использование формы
на стороне сервера оказывается неприемлемым.
Обычно в простой, отсылаемой назад форме достаточно ограничиться одной
страницей и воспользоваться событием Onclick для кнопки отправки (кнопки
Vote), которая позволяет зарегистрировать выбор посетителя. Однако, чтобы
избежать использования форм на стороне
сервера, мы собираемся использовать две
страницы. На первой из них будет выво-
диться вопрос и перечень возможных отве-
тов, а рядом с каждым ответом — ссылка
Vote (Голосую за). Эта ссылка позволяет
передать в качестве параметра номер вы-
бранного ответа второй странице, которая
использует переданное ей значение для ре-
гистрации голоса, после чего выводит на
экран текущие результаты голосования.
Как должна выглядеть первая страни-
ца—default.aspx, показано на рисунке
слева.
I [gPersonatBar ^Search
Какой язык программирования вы, в основном, используете?
Голосую за С#
Голосую за C++
Голосую за Java
Голосую за JavaScript
Голосую за Visual Basic
"ГГТ
А вот как должна выглядеть вторая стра-
ница — vote.aspx, представлено на рисунке
справа.
Первая страница — default.aspx — пред-
ставляет опрос, и когда мы выбираем первый
из возможных ответов с помощью ссылки
Vote, то видим, что странице vote.aspx
в строке URL передается единица. Данный
параметр используется для регистрации го-
лоса. После этого vote.aspx выводит все ва-
рианты ответов со счетчиками голосов для
каждого из них.
? :1££\'<
Fib E<& Vim
Address {:
т„•: - :• ^
У •$Search Qj
Голосование oo вопросу "Какой язык программировании
вы, в основном, используете?"
С# 15 голосов
О+ 2 голоса
Java 35 голосов
JavaScript 12 голосов
Visual Basic 42 голоса
£|~ Local intiane* /X
Практический пример 1 — юеЪ-сайт для проведения опросов 767
Начнем с файла ASP.NET default.aspx, созданного Visual Studio.NET. Эта
страница является стандартной и в ней содержится несколько тегов, в частности,
внешние HTML-теги, а также теги <%@ Page Ianguuge="c#" Codebehind="Default.aspx.cs" AutoEventWireup="false"
Inherits=PollW.WebForml" %>
. ; > ; / :

Практический пример 1 - web-сайт для проведения опросов

basic — Wed, 10 Feb 2010 21:56:37 GMT