ASP Краткий справочник


Краткий справочник по ASP от Example Tutorial. Распечатайте его и держите в кармане для использования в любое время.


Базовый синтаксис

Сценарии ASP заключаются в <% и %>. Чтобы записать вывод в браузер:

<html>
<body>
<% response.write("Hello World!") %>
</body>
</html>

Язык по умолчанию в ASP — VBScript. Чтобы использовать другой язык сценариев, вставьте объявление языка в верхней части ASP-страницы:

<%@ language="javascript" %>
<html>
<body>

<%
....
%>

Формы и пользовательский ввод

Request.QueryString используется для сбора значений из формы с method="get". Информация, отправляемая из формы с использованием метода GET, видна всем пользователям (она отображается в адресной строке браузера) и имеет ограничения на объем информации, который можно отправить.

Request.Form используется для сбора значений из формы с использованием method="post". Информация, отправляемая из формы с использованием метода POST, невидима для пользователей и не имеет ограничений на объем информации, который можно отправить.

Файлы cookie ASP

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

Команда Response.Cookies используется для создания cookie:

<%
Response.Cookies("firstname")="Alex"
Response.Cookies("firstname").Expires="May 10,2002"
%>

Примечание:Команда Response.Cookies должна располагаться перед тегом <html>!

Команда "Request.Cookies" используется для получения значения cookie:

<%
fname=Request.Cookies("firstname")
response.write("Firstname=" & fname)
%>

Включение файлов

Используя директиву #include, можно вставить содержимое другого ASP-файла в ASP-файл до того, как сервер выполнит его. Директива #include используется для создания функций, верхних и нижних колонтитулов или других элементов, которые нужно повторно использовать на нескольких страницах.

Синтаксис:

<!--#include virtual="somefile.inc"-->
Или
<!--#include file ="somefile.inc"-->

Используйте ключевое слово virtual, чтобы указать путь, начинающийся с виртуального каталога. Если файл с именем "header.inc" находится в виртуальном каталоге /html, следующая строка кода вставит содержимое файла "header.inc":

<!-- #include virtual ="/html/header.inc" -->

Используйте ключевое слово file, чтобы указать относительный путь. Относительный путь начинается с каталога, содержащего ссылающийся файл. Если у вас есть файл в каталоге html, а файл "header.inc" находится в каталоге html, следующая строка кода вставит содержимое файла "header.inc" в ваш файл:

<!-- #include file ="headersheader.inc" -->

Используйте ключевое слово file с синтаксисом (..) для ссылки на файл в каталоге более высокого уровня.

Global.asa

Файл Global.asa — это необязательный файл, который может содержать объявления объектов, переменных и методов, доступных каждой странице приложения ASP.

Примечание:Файл Global.asa должен храниться в корневом каталоге ASP-приложения, и каждое приложение может иметь только один файл Global.asa.

Файл Global.asa может содержать только следующее:

  • События приложения
  • События сеанса
  • Объявления <object>
  • Объявления TypeLibrary
  • Директива #include

События Application и Session

В Global.asa можно указать объектам application и session, что делать при запуске приложения/сеанса и что делать при завершении приложения/сеанса. Код, выполняющий эту задачу, размещается в обработчиках событий.Примечание:Поскольку мы не можем использовать разделители скриптов ASP (<% и %>) для вставки скриптов в файл Global.asa, нам нужно разместить подпрограммы внутри тегов HTML <script>:

<script language="vbscript" runat="server">
sub Application_OnStart
' some code
end sub
sub Application_OnEnd
' some code
end sub
sub Session_OnStart
' some code
end sub
sub Session_OnEnd
' some code
end sub
</script>

Объявления <object>

Объекты с областью действия session или application можно создавать в файле Global.asa с помощью тега <object>.Примечание:Тег <object> должен располагаться вне тега <script>!

Синтаксис:

<object runat="server" scope="scope" id="id"
{progid="progID"|classid="classID"}>
.......
</object>

Объявление TypeLibrary

TypeLibrary (библиотека типов) — это контейнер, содержащий DLL-файлы, соответствующие COM-объектам. Включив вызов TypeLibrary в файл Global.asa, вы можете получить доступ к константам COM-объектов, а код ASP также сможет лучше сообщать об ошибках. Если ваше веб-приложение зависит от COM-объектов, типы данных которых уже объявлены в библиотеке типов, вы можете объявить библиотеку типов в Global.asa.

Синтаксис:

<!--METADATA TYPE="TypeLib"
file="filename"
uuid="typelibraryuuid"
version="versionnumber"
lcid="localeid"
-->

Объект Session

Объект Session используется для хранения информации о сеансе пользователя или для изменения параметров сеанса пользователя. Переменные, хранящиеся в объекте Session, содержат информацию об отдельном пользователе и доступны на всех страницах приложения.

Коллекции

  • Contents - Содержит все элементы, добавленные в сеанс с помощью команд сценария.
  • StaticObjects - Содержит все объекты, добавленные в сеанс с помощью HTML-тега <object>.
  • Contents.Remove(item/index) - Удаляет элемент из коллекции Contents.
  • Contents.RemoveAll() - Удаляет все элементы из коллекции Contents.

Свойства

  • CodePage - Указывает набор символов, используемый при отображении динамического содержимого.
  • LCID - Задает идентификатор языкового стандарта, используемый для отображения динамического содержимого.
  • SessionID - Возвращает идентификатор сеанса.
  • Timeout - Задает или возвращает период ожидания для сеанса.

Методы

  • Abandon - Уничтожает все объекты в объекте сеанса.

Объект Application

Группа файлов ASP, которые работают вместе для выполнения задачи, называется приложением. Объект Application используется для связывания этих файлов вместе. Все пользователи совместно используют один объект Application. Объект Application хранит информацию, которая будет использоваться многими страницами в приложении (например, сведения о подключении к базе данных).

Коллекции

  • Contents - Содержит все элементы, добавленные в приложение с помощью команд сценария.
  • StaticObjects - Содержит все объекты, добавленные в приложение с помощью HTML-тега <object>.
  • Contents.Remove - Удаляет элемент из коллекции Contents.
  • Contents.RemoveAll - Удаляет все элементы из коллекции Contents.

Методы

  • Lock - Запрещает пользователям изменять свойства объекта Application.
  • Unlock - Разрешает пользователям изменять свойства объекта Application.

Объект Response

Объект Response используется для отправки выходных данных с сервера пользователю.

Коллекции

  • Cookies(name) - Задает значение cookie. Если cookie не существует, создает cookie и задает указанное значение.

Свойства

  • Buffer - Указывает, следует ли буферизовать вывод. Когда вывод буферизуется, сервер задерживает ответ браузеру до тех пор, пока не будут обработаны все серверные сценарии или пока сценарий не вызовет метод Flush или End. Если вы хотите задать это свойство, его следует разместить перед тегом <html> в ASP-файле.
  • CacheControl - Определяет, могут ли прокси-серверы кэшировать вывод, создаваемый ASP. Если установлено значение Public, прокси-серверы будут кэшировать страницу.
  • Charset(charset_name) - Добавляет имя набора символов (например, "ISO8859-1") в заголовок content-type объекта Response.
  • ContentType - Задает HTTP-тип содержимого объекта Response (например, "text/html", "image/gif", "image/jpeg", "text/plain"). По умолчанию — "text/html".
  • Expires - Задает время кэширования в браузере (в минутах) до истечения срока действия страницы.
  • ExpiresAbsolute - Задает дату и время, когда истекает срок действия страницы, кэшированной в браузере.
  • IsClientConnected - Указывает, отключился ли клиент от сервера.
  • Pics(pics_label) - Добавляет значение в тег PICS в заголовке ответа.
  • Status - Задает значение строки состояния, возвращаемой сервером.

Методы

  • AddHeader(name, value) - Добавляет новый HTTP-заголовок и значение в HTTP-ответ.
  • AppendToLog string - Добавляет строку в конец записи журнала сервера.
  • BinaryWrite(data_to_write) - Записывает данные непосредственно в вывод без какого-либо преобразования символов.
  • Clear - Очищает буферизованный вывод. Используйте этот метод для обработки ошибок. Если для Response.Buffer не задано значение true, этот метод вызовет ошибку времени выполнения.
  • End - Останавливает обработку сценария и возвращает текущий результат.
  • Flush - Немедленно отправляет буферизованный вывод. Если для Response.Buffer не задано значение true, этот метод вызовет ошибку времени выполнения.
  • Redirect(url) - Перенаправляет пользователя на другой URL.
  • Write(data_to_write) - Записывает текст пользователю.

Объект Request

Когда браузер запрашивает страницу с сервера, такое поведение называется запросом. Объект Request используется для получения информации от пользователя.

Коллекции

  • ClientCertificate — содержит все значения полей, хранящиеся в клиентском сертификате.
  • Cookies(name) — содержит все значения cookie, отправленные в HTTP-запросе.
  • Form(element_name) — содержит все значения формы (полей ввода), отправленные формой с использованием метода POST.
  • QueryString(variable_name) — содержит все значения переменных в строке запроса HTTP.
  • ServerVariables(server_variable) — содержит все значения серверных переменных.

Свойства

  • TotalBytes — возвращает общее количество байтов, отправленных клиентом в теле запроса.

Методы

  • BinaryRead — извлекает данные, отправленные от клиента на сервер в составе POST-запроса.

Объект Server

Объект Server используется для доступа к свойствам и методам на сервере.

Свойства

  • ScriptTimeout — задает или возвращает максимальное время в секундах, в течение которого скрипт может выполняться до его остановки.

Методы

  • CreateObject(type_of_object) — создает экземпляр объекта.
  • Execute(path) — выполняет другой ASP-файл изнутри ASP-файла. После завершения выполнения вызванного ASP-файла управление возвращается к исходному ASP-файлу.
  • GetLastError() — возвращает объект ASPError, описывающий возникшее состояние ошибки.
  • HTMLEncode(string) - Применяет HTML-кодирование к строке.
  • MapPath(path) - Сопоставляет относительный или виртуальный путь с физическим путём.
  • Transfer(path) - Передаёт всю информацию о состоянии в другой файл для обработки. После передачи управление программой не возвращается к исходному ASP-файлу.
  • URLEncode(string) - Применяет правила URL-кодирования к строке.
Другие расширения