ASP файл Global.asa
файл Global.asa
Файл Global.asa — это необязательный файл, который может содержать объявления объектов, переменных и методов, к которым может получить доступ каждая страница в приложении ASP.
Все допустимые браузерные скрипты (JavaScript, VBScript, JScript, PerlScript и т. д.) можно использовать в Global.asa.
Файл Global.asa может содержать только следующее:
- События приложения
- События сеанса
- объявления <object>
- объявления TypeLibrary
- директивы #include
Примечание:Файл Global.asa должен храниться в корневом каталоге приложения ASP, и каждое приложение может иметь только один файл Global.asa.
События в Global.asa
В Global.asa можно указать объектам application и session, что делать при запуске приложения/сеанса и что делать при завершении приложения/сеанса. Код, выполняющий эту задачу, размещается в обработчиках событий. Файл Global.asa может содержать четыре типа событий:
Application_OnStart- Это событие происходит, когда первый пользователь вызывает первую страницу ASP-приложения. Это событие происходит после перезапуска веб-сервера или редактирования файла Global.asa. Событие "Session_OnStart" происходит сразу после этого события.Session_OnStart- Это событие происходит всякий раз, когда новый пользователь запрашивает свою первую страницу в ASP-приложении.
Session_OnEnd- Это событие происходит всякий раз, когда пользователь завершает сеанс. Если пользователь не запрашивает какие-либо страницы в течение заданного времени (по умолчанию — 20 минут), сеанс пользователя завершается.
Application_OnEnd- Это событие происходит после того, как последний пользователь завершает свой сеанс. Обычно это событие происходит при остановке веб-сервера. Эта подпрограмма используется для очистки настроек после остановки приложения, например для удаления записей или записи информации в текстовый файл.
Файл Global.asa может выглядеть так:
sub Application_OnStart
'некоторый код
end sub
sub Application_OnEnd
'некоторый код
end sub
sub Session_OnStart
'некоторый код
end sub
sub Session_OnEnd
'некоторый код
end sub
</script>
Примечание:Поскольку мы не можем использовать разделители скриптов ASP (<% и %>) для вставки скриптов в файл Global.asa, нам нужно разместить подпрограммы внутри HTML-элемента <script>.
Объявление <object>
Объекты с областью действия сеанса или приложения можно создавать в файле Global.asa с помощью тега <object>.
Примечание:Тег <object> должен быть размещён вне тега <script>!
Синтаксис
....
</object>
| Parameters | Описание |
|---|---|
| scope | Задаёт область действия объекта (Session или Application). |
| id | Задаёт уникальный id для объекта. |
| ProgID | Идентификатор, связанный с ClassID. Формат ProgID: [Vendor.]Component[.Version]. Необходимо указать либо ProgID, либо ClassID. |
| ClassID | Задает уникальный идентификатор для объекта COM-класса. Необходимо указать либо ProgID, либо ClassID. |
Примеры
Первый пример создает объект с областью видимости сеанса с именем "MyAd", используя параметр ProgID:
</object>
Второй пример создает объект с областью видимости приложения с именем "MyConnection", используя параметр ClassID:
classid="Clsid:8AD3067A-B3FC-11CF-A560-00A0C9081C21">
</object>
Объекты, объявленные в файле Global.asa, могут использоваться любым скриптом в приложении:
<object runat="server" scope="session" id="MyAd" progid="MSWC.AdRotator">
</object>
Вы можете ссылаться на объект "MyAd" с любой страницы в приложении ASP:
Некоторый .ASP-файл:
<%=MyAd.GetAdvertisement("/banners/adrot.txt")%>
Объявление TypeLibrary
TypeLibrary — это контейнер, содержащий DLL-файлы, соответствующие COM-объектам. Включив вызов TypeLibrary в файл Global.asa, вы можете получить доступ к константам COM-объекта, а код ASP также может лучше сообщать об ошибках. Если ваше веб-приложение зависит от COM-объектов, типы данных которых объявлены в библиотеке типов, вы можете объявить библиотеку типов в Global.asa.
Синтаксис
file="filename" uuid="id" version="number" lcid="localeid"
-->
| Parameters | Описание |
|---|---|
| файл | Указывает абсолютный путь к библиотеке типов. Параметр file или параметр uuid обязателен; должен присутствовать один из двух. |
| uuid | Указывает уникальный идентификатор библиотеки типов. Параметр file или параметр uuid обязателен; должен присутствовать один из двух. |
| version | Необязательно. Используется для выбора версии. Если требуемая версия не найдена, будет использована ближайшая версия. |
| lcid | Необязательно. Используется для идентификатора локали библиотеки типов. |
Значения ошибок
Сервер вернет одно из следующих сообщений об ошибках:
| Код ошибки | Описание |
|---|---|
| ASP 0222 | Недопустимая спецификация библиотеки типов |
| ASP 0223 | Библиотека типов не найдена |
| ASP 0224 | Не удалось загрузить библиотеку типов |
| ASP 0225 | Не удалось обернуть библиотеку типов |
Примечания:Тег METADATA может находиться в любом месте файла Global.asa (как внутри, так и вне тегов <script>). Однако мы по-прежнему рекомендуем размещать тег METADATA в верхней части файла Global.asa.
Ограничения
Ограничения относительно того, на что можно ссылаться в файле Global.asa:
- Вы не можете отображать текст из файла Global.asa. Этот файл не может отображать информацию.
- Вы можете использовать только объекты Server и Application в подпрограммах Application_OnStart и Application_OnEnd. В подпрограмме Session_OnEnd можно использовать объекты Server, Application и Session. В подпрограмме Session_OnStart можно использовать любые встроенные объекты.
Как использовать подпрограммы
Global.asa часто используется для инициализации переменных.
В следующем примере показано, как определить точное время, когда посетитель впервые приходит на веб-сайт. Время сохраняется в объекте Session с именем "started", и любая ASP-страница приложения может получить доступ к значению переменной "started":
sub Session_OnStart
Session("started")=now()
end sub
</script>
Global.asa также можно использовать для управления доступом к страницам.
В следующем примере показано, как перенаправлять каждого нового посетителя на другую страницу; в этом примере они перенаправляются на страницу с именем "newpage.asp":
sub Session_OnStart
Response.Redirect("newpage.asp")
end sub
</script>
Вы можете включать функции в файл Global.asa.
В следующем примере, когда запускается веб-сервер, также запускается подпрограмма Application_OnStart. Затем подпрограмма Application_OnStart вызывает другую подпрограмму с именем "getcustomers". Подпрограмма "getcustomers" открывает базу данных и извлекает набор записей из таблицы "customers". Этот набор записей присваивается массиву, и любая ASP-страница может получить доступ к этому массиву без запроса к базе данных:
sub Application_OnStart
getcustomers
end sub
sub getcustomers
set conn=Server.CreateObject("ADODB.Connection")
conn.Provider="Microsoft.Jet.OLEDB.4.0"
conn.Open "c:/webdata/northwind.mdb"
set rs=conn.execute("select name from customers")
Application("customers")=rs.GetRows
rs.Close
conn.Close
end sub
</script>
Пример Global.asa
В этом примере мы создадим файл Global.asa, который подсчитывает текущее количество посетителей.
- При запуске сервера Application_OnStart устанавливает значение переменной Application "visitors" равным 0.
- Каждый раз, когда приходит новый посетитель, подпрограмма Session_OnStart увеличивает переменную "visitors" на 1.
- Каждый раз, когда срабатывает подпрограмма Session_OnEnd, она уменьшает переменную "visitors" на 1.
Файл Global.asa:
Sub Application_OnStart
Application("visitors")=0
End Sub
Sub Session_OnStart
Application.Lock
Application("visitors")=Application("visitors")+1
Application.UnLock
End Sub
Sub Session_OnEnd
Application.Lock
Application("visitors")=Application("visitors")-1
Application.UnLock
End Sub
</script>
Отобразить текущее количество посетителей в ASP-файле:
<html>
<head>
</head>
<body>
<p>Сейчас <%response.write(Application("visitors"))%> онлайн!</p>
</body>
</html>
Другие расширения