Главная » Статьи » Visual Basic » Библиотека Visual Basic

@ Control
Определяет атрибуты, характерные для пользовательских элементов управления (ASCX-файлов), которые используются анализатором и компилятором страниц ASP.NET.Эта директива может использоваться только с объектам, исходный код которых содержится в файлах ASCX).

<%@ Control attribute="value" [attribute="value" ...  ] %>

Атрибуты

AutoEventWireup

Указывает, будут ли события элемента управления автоматически связываться друг с другом.true, если включена автоматическая запись события; в противном случае false. Значение по умолчанию равно true.

ClassName

Строка, указывающая для элемента управления имя класса, который будет динамически компилироваться при запросе этого элемента.Этим значением может быть любое действительное имя класса, и оно может включать полное пространство имен класса (полное имя класса).Если для данного атрибута значение не указано, имя класса для скомпилированного элемента управления создается на основе имени файла этого элемента.

Другая страница или элемент управления может ссылаться на назначенное элементу управления имя класса с помощью директивы @ Reference.

ClientIDMode

Задает алгоритм, используемый для формирования значений ClientID для элементов управления. Значение для страницы по умолчанию равно AutoID.

По умолчанию для элементов управления установлено значение Inherit. Соответственно, алгоритм по умолчанию для пользовательского элемента управления определяется его параметром ClientID. Другое значение по умолчанию может быть задано на уровне страницы в директиве @ Page или в элементе pages файла Web.config. Дополнительные сведения об алгоритмах см. в описании ClientIDMode.

CodeBehind

Задает имя откомпилированного файла, содержащего связанный с элементом управления класс.Этот атрибут не используется в процессе выполнения.

 Примечание
Этот атрибут не обрабатывается для языков, отличных от Visual Basic.Кроме того, для этого параметра устанавливается значение true в файле конфигурации Machine.config.

Inherits

Определяет класс с выделенным кодом для элемента управления.Этот класс может быть любым классом, производным от класса UserControl. Используется с атрибутом CodeFile, содержащим путь к исходному файлу для класса с выделенным кодом.

Language

Задает язык, используемый при компиляции всех находящихся внутри элемента управления встроенных блоков выполнения (<% %> and <%= %>) и объявлений кода.Значение может быть любым поддерживаемым .NET Framework языком, включая Visual Basic, C# или JScript.Для каждого элемента управления используется и задается только один язык.

LinePragmas

Определяет, должна ли среда выполнения создавать строки директивы pragma в исходном коде.Эти параметры компилятора часто используются средствами отладки для отметки определенных мест в исходном файле.true, если следует создавать строковые прагмы; в противном случае  false.

Src

Задает путь к исходному файлу, содержащему связанный с элементом управления код.В связанном исходном файле использовать логику программирования для элемента управления можно как в классе, так и в блоках объявлений кода.

Атрибут Src используется для связи поставщиков построения с элементом управления. Дополнительные сведения см. в разделах BuildProvider. В версиях ASP.NET, предшествовавших версии 2.0, атрибут Src применялся в качестве альтернативы для связи файла кода программной части с элементом управления. В ASP.NET версии 2.0 рекомендуемым способом связи исходного файла фонового кода с элементом управления является использование атрибута Inherits для определения класса, а также атрибута CodeFile для задания пути к исходному файлу для класса.

Strict

Указывает, что элемент управления должен компилироваться с помощью режима OptionStrict Visual Basic. true, если Option Strict включен, в противном случае — false. Значение по умолчанию: false.

 Примечание
Этот атрибут не обрабатывается для языков, отличных от Visual Basic.

TargetSchema

Задает имя схемы, которая служит для проверки содержимого в элементе управления.Это используется только в описательных целях. В действительности проверка не производится и анализатор пропускает атрибут.

WarningLevel


Определяет уровень предупреждений компилятора, при котором он будет рассматривать предупреждения как ошибки, прерывая, таким образом, компиляцию элемента управления.Возможны уровни предупреждений от 0 до 4.Дополнительные сведения см. в описании свойства WarningLevel.

Заметки

Эта директива может использоваться только в пользовательских элементах управления.Пользовательские элементы управления определяются в файлах с расширением .ascx.Один файл .ascx может содержать только одну директиву @ Control. Для каждой директивы @ Control определяется только один атрибут Language, поскольку для элемента управления можно использовать только один язык.

 Примечание
Директива @ Control располагает рядом атрибутов, общих для других директив, которые применяются ко всему исходному файлу, например директива @ Page (используется в файлах .aspx для веб-страниц) и директива @ Master (используется в файлах .master для главных страниц).

Чтобы определить несколько атрибутов для директивы @ Control, каждую пару атрибут/значение следует разделить одиночным пробелом. Для определения конкретного атрибута не используйте пробел ни с какой стороны знака равенства (=), связывающего атрибут с его значением.Пример см. в разделе "Пример".

Пример

В приведенном ниже примере коде указывается, что компилятор страниц ASP.NET должен рассматривать Visual Basic как язык встраиваемого кода, а также запрещается хранение состояния представления HTTP-запросов с помощью атрибута EnableViewState.

<%@ Control Language="VB" EnableViewState="false" %>






Источник: http://expert1.ucoz.com/
Категория: Библиотека Visual Basic | Добавил: hitman (05.04.2012)
Просмотров: 1473 | Теги: vb library | Рейтинг: 0.0/0
Всего комментариев: 0
Имя *:
Email *:
Код *: