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 может выглядеть так:

<script language="vbscript" runat="server">

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 runat="server" scope="scope" id="id" {progid="progID"|classid="classID"}>
....
</object>

Parameters Описание
scope Задаёт область действия объекта (Session или Application).
id Задаёт уникальный id для объекта.
ProgID Идентификатор, связанный с ClassID. Формат ProgID: [Vendor.]Component[.Version].

Необходимо указать либо ProgID, либо ClassID.

ClassID Задает уникальный идентификатор для объекта COM-класса.

Необходимо указать либо ProgID, либо ClassID.

Примеры

Первый пример создает объект с областью видимости сеанса с именем "MyAd", используя параметр ProgID:

<object runat="server" scope="session" id="MyAd" progid="MSWC.AdRotator">
</object>

Второй пример создает объект с областью видимости приложения с именем "MyConnection", используя параметр ClassID:

<object runat="server" scope="application" id="MyConnection"
classid="Clsid:8AD3067A-B3FC-11CF-A560-00A0C9081C21">
</object>

Объекты, объявленные в файле Global.asa, могут использоваться любым скриптом в приложении:

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.

Синтаксис

<!--METADATA TYPE="TypeLib"
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":

<script language="vbscript" runat="server">
sub Session_OnStart
Session("started")=now()
end sub
</script>

Global.asa также можно использовать для управления доступом к страницам.

В следующем примере показано, как перенаправлять каждого нового посетителя на другую страницу; в этом примере они перенаправляются на страницу с именем "newpage.asp":

<script language="vbscript" runat="server">
sub Session_OnStart
Response.Redirect("newpage.asp")
end sub
</script>

Вы можете включать функции в файл Global.asa.

В следующем примере, когда запускается веб-сервер, также запускается подпрограмма Application_OnStart. Затем подпрограмма Application_OnStart вызывает другую подпрограмму с именем "getcustomers". Подпрограмма "getcustomers" открывает базу данных и извлекает набор записей из таблицы "customers". Этот набор записей присваивается массиву, и любая ASP-страница может получить доступ к этому массиву без запроса к базе данных:

<script language="vbscript" runat="server">

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:

<script language="vbscript" runat="server">

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-файле:

<!DOCTYPE html>
<html>
<head>
</head>
<body>
<p>Сейчас <%response.write(Application("visitors"))%> онлайн!</p>
</body>
</html>

Другие расширения