ASP - Объявления библиотеки типов
Библиотека типов — это файл, содержащий сведения об объектах и типах, поддерживаемых компонентом COM. Общепринятым является объявление констант, поддерживаемых компонентом COM, в библиотеке типов. Если веб-приложение основывается на объектах COM, которые содержат объявленные типы данных в библиотеке типов, можно объявить библиотеки типов в Global.asa. Сделав так, становится возможным ссылаться на константы, объявленные в библиотеках типов, из любого сценария в пределах приложения.
Дополнительные сведения об использовании констант в ASP см. в разделе Использование переменных и констант.
Синтаксис
<!--METADATA TYPE="TypeLib"
FILE="файл"
UUID="ИдентификаторБиблиотеки"
VERSION="ГлавныйНомерВерсии.ВспомогательныйНомерВерсии"
LCID="ЛокальныйИдентификатор"
-->
Параметры
файл
Абсолютный путь к библиотеке типов. Если указан этот параметр и ИдентификаторБиблиотеки, файл используется для идентификации библиотеки типов. Требуется или параметр файл, или параметр ИдентификаторБиблиотеки.
ИдентификаторБиблиотеки
Универсальный уникальный идентификатор библиотеки типов. Требуется или параметр файл, или параметр ИдентификаторБиблиотеки.
ГлавныйНомерВерсии
Используется для выбора версии. Если требуемая версия не найдена, используется последняя версия (необязательный параметр).
ВспомогательныйНомерВерсии
Используется для выбора версии. Если требуемая версия не найдена, используется последняя версия (необязательный параметр).
ЛокальныйИдентификатор
Локальный идентификатор, используемый для библиотеки типов. Если указанная местность не найдена, используется системный локальный идентификатор. (необязательный параметр)
Значения ошибок
Сервер может вернуть одно из перечисленных ниже сообщений об ошибке.
| Ошибка | Описание |
| ASP 0222 | Неправильное задание библиотеки типов. Тег METADATA содержит неправильную спецификайию библиотеки типов. |
| ASP 0223 | Библиотека типов не найдена. Тег METADATA содержит спецификацию, которая не совпадает ни с одной записью реестра. |
| ASP 0224 | Библиотека типов не может быть загружена. ASP не может загрузить библиотеку типов, указанную тегом METADATA. |
| ASP 0225 | Невозможно создание оболочки для библиотек типов. ASP не может создать объект Type Library Wrapper из библиотек типов, указанных в теге METADATA. |
Примечания
Рекомендуется использовать теги METADATA в начале файла Global.asa. однако эти теги могут появляться в любом месте внутри файла Global.asa, как внутри, так и вне тегов SCRIPT.
Чтобы избежать неоднозначных ссылок на константы, используйте имя библиотеки типов в качестве префикса для константы. Например, ADODB.adErrItemNotFound более однозначно, чем adErrItemNotFound.
Если для создания файла Global.asa используется Microsoft Visual InterDev, теги METADATA будут включать необязательные ключевые слова STARTSPAN и ENDSPAN. Эти ключевые слова игнорируются IIS.
Если для библиотеки типов не указан локальный идентификатор, используется системный локальный идентификатор по умолчанию. Если стандартный системный локальный идентификатор не может быть использован, а локальный идентификатор не указан, локальный идентификатор для библиотеки типов устанавливается в 0.
Пример
MyComponent в приведенном ниже примере разработан с помощью Visual Basic 5.0. MyComponent определяет константу MyError с помощью следующего оператора.
Public Const MyError = "You are not using MyComponent correctly."
Библиотека типов содержится в mycomponent.lib, которая установлена в каталоге
C:\MyComponent
Приведенный ниже тег METADATA включен в файл Global.asa для приложения MyApp.
<!--METADATA TYPE="TypeLib"
FILE="MyComponent.tlb"
-->
Любой файл .asp в приложении MyApp теперь может включать следующий сценарий:
<%
Dim MyVar
Set MyVar = Server.CreateObject("MyComponent.MyClass")
Currentreturn = MyVar.MyMethod
If Currentreturn = False
Response.Write(MyError)
End If
%>