Quick Reference ASP

Справочник ASP от CodeW3C.com. Печатайте и храните в кармане, чтобы использовать в любое время.

Основная грамматика

ASP скрипты окружены <% и %>.

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

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

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

Формы и ввод пользователя

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

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

ASP Cookies

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

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

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

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

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

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

Указание файла

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

Синтаксис:

<!--#include virtual="somefile.inc"-->

или

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

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

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

Если ваш файл находится в каталоге html, а файл "header.inc" находится в html\headers,下面的代码将在 вашем файле вставить содержимое "header.inc":

Используйте ключевое слово file для указания относительного пути. Относительный путь начинается с каталога, содержащего файл с ссылкой.

<!-- #include file ="headers\header.inc" -->

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

Global.asa

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

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

  • События Application
  • События Session
  • <object> объявление
  • Декларация TypeLibrary
  • Инструкция #include

События Application и Session

В файле Global.asa вы можете указать, что делать объектам application и session при их запуске и завершении. Код для выполнения этой задачи находится в обработчиках событий.

Комментарий: При вставке кода в файл Global.asa, мы не используем <% и %>, нам нужно поместить подпрограмму в тег <script> HTML:

<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> объявление

Используя тег <object>, также можно создавать объекты с глобальным или сессийным масштабом в файле Global.asa.

Комментарий: Тег <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 - включает все элементы, добавленные к session с помощью команд скрипта
  • StaticObjects - содержит все объекты, добавленные к session с помощью тега <object> HTML
  • Contents.Remove(item/index) - удаляет один элемент из коллекции Contents
  • Contents.RemoveAll() - удаляет все элементы из коллекции Contents

Свойство

  • CodePage - определяет кодовую страницу, используемую для отображения динамического контента
  • LCID - устанавливает идентификатор региона для отображения динамического контента
  • SessionID - возвращает идентификатор session
  • Timeout - устанавливает или возвращает время ожидания session

Метод

  • Abandon - аннулирует все объекты в объекте session

Объект Application

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

Коллекция

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

Метод

  • Lock - Предотвращает пользователей от изменения переменных объекта Application
  • Unlock - Разрешает пользователям изменять переменные объекта Application

Объект Response

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

Коллекция

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

Свойство

  • Buffer - Определяет, следует ли буферизировать вывод. При буферизации вывода сервер блокирует ответ браузеру до обработки всех серверных скриптов или до вызова методов Flush или End. Если необходимо установить этот параметр, он должен быть расположен до тега <html> в файле .asp
  • CacheControl - Устанавливает, может ли кэш-сервер хранить результаты вывода ASP. Если установлено Public, кэш-сервер будет хранить страницу.
  • Charset(charset_name) - Добавление имени кодировки символов к заголовку content-type объекта ответа
  • ContentType - Устанавливает тип HTTP содержимого объекта ответа. Например, "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 - Добавление строки в конец серверного журнала проекта (server log entry)
  • BinaryWrite(data_to_write) - Запись данных в вывод без преобразования символов
  • Clear - Удаление накопленных данных. Используйте этот метод для обработки ошибок. Если Response.Buffer не установлено в true, этот метод вызовет runtime-ошибку
  • End - Остановка обработки скрипта и возврат текущего результата
  • Flush - Отправка накопленных данных в缓存. Если Response.Buffer не установлено в true, этот метод вызовет runtime-ошибку
  • Redirect(url) - Перенаправление пользователя на другой URL
  • Write(data_to_write) - Запись текста для пользователя

Объект Request

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

Коллекция

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

Свойство

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

Метод

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

Объект Server

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

Свойство

ScriptTimeout - Установка или возврат времени, в течение которого скрипт может выполняться до его终止а.

Метод

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

Источник: http://www.codew3c.com/asp/asp_quickref.asp