@ Control
Обновлен: Ноябрь 2007
Определяет атрибуты, характерные для пользовательского элемента управления (файла .aspx), используемые анализатором и компилятором страниц ASP.NET. Эта директива может использоваться только с Пользовательские элементы управления ASP.NET (чей исходный код содержится в файлах .ascx).
<%@ Control attribute="value" [attribute="value" ... ] %>
Атрибуты
AutoEventWireup
Указывает, будут ли события элемента управления автоматически связываться друг с другом. Если включено автоматическое связывание, то устанавливается значение true; в противном случае — false. По умолчанию используется значение true. Дополнительные сведения см. в разделе Модель событий серверного веб-элемента управления ASP.NET.ClassName
Строка, указывающая для элемента управления имя класса, который будет динамически компилироваться при запросе этого элемента. Этим значением может быть любое действительное имя класса, и оно может включать полное пространство имен класса (полное имя класса). Если для данного атрибута значение не указано, имя класса для скомпилированного элемента управления создается на основе имени файла этого элемента.Другая страница или элемент управления может ссылаться на имя класса, назначенное элементу управления, с помощью директивы @ Reference.
CodeBehind
Задает имя откомпилированного файла, содержащего связанный с элементом управления класс. Этот атрибут не используется в процессе выполнения..gif "Примечание")
Примечание.Этот атрибут включен для обеспечения совместимости с предыдущими версиями ASP.NET и используется для реализации функции фонового кода. Чтобы задать имя исходного файла, в ASP.NET версии 2.0 следует использовать атрибут CodeFile, а чтобы задать полное имя класса — атрибут Inherits.
CodeFile
Задает путь к указываемому файлу кода программной части для элемента управления. Для связи исходного файла кода программной части с пользовательским элементом управления этот атрибут используется вместе с атрибутом Inherits. Атрибут является допустимым только для скомпилированных элементов управления.CodeFileBaseClass
Задает путь к базовому классу для элемента управления и связанного с ним класса с выделенным кодом. Этот атрибут является необязательным, однако если он используется, атрибут CodeFile тоже должен присутствовать. Данный атрибут применяется при реализации общего сценария, в котором в базовом классе определяются общие поля (и дополнительно связанные события) для ссылки на элементы управления, объявленные в пользовательском элементе управления. В связи с особенностями модели создания кода ASP.NET, при определении полей в базовом классе без использования данного атрибута во время компиляции будут созданы новые определения членов для элементов управления, объявленных в пользовательском элементе (в заглушке отдельного разделяемого класса), и требуемый сценарий не будет работать. Однако если атрибут CodeFileBaseClass используется для связи базового класса с пользовательским элементом управления и частичный класс (его имя назначено атрибуту Inherits и на его исходный файл ссылается атрибут CodeFile) наследуется из базового класса, то после создания кода поля в базовом классе смогут ссылаться на элементы управления в пользовательском элементе.CompilationMode
Указывает, должна ли для компиляции элемента управления использоваться строка, определяющая один из нескольких перечисляемых параметров. По умолчанию используется значение Always, поэтому компиляция элементов управления .aspx выполняется по умолчанию. Дополнительные сведения см. в перечислении CompilationMode.CompilerOptions
Строка, содержащая параметры компилятора, используемые для компиляции элемента управления. Для C# и Visual Basic эта строка представляет собой последовательность переключателей командной строки компилятора. Дополнительные сведения о параметрах компилятора см. в разделе Параметры компилятора C# или Компилятор Visual Basic.Debug
Указывает, будет ли элемент управления компилироваться с отладочными символами. Если элемент управления компилируется с отладочными символами, устанавливается значение true; в противном случае — false. Поскольку данный параметр влияет на производительность, данному атрибуту следует задать значение true во время разработки.Description
Предоставляет текстовое описание элемента управления. Это значение не обрабатывается анализатором ASP.NET.EnableTheming
Определяет, используются ли темы в элементе управления. Если темы используются, значение — true; в противном случае — false. По умолчанию используется значение true.EnableViewState
Определяет, сохраняется ли состояние представления между запросами к элементу управления. Если состояние сохраняется, значение — true; в противном случае — false. По умолчанию используется значение true.Explicit
Определяет, скомпилирована ли страница с помощью режима Option Explicit Visual Basic. Значение true указывает, что данный параметр компиляции включен и что все переменные должны объявляться с помощью оператора Dim, Private, Public или ReDim; в противном случае значение — false. По умолчанию используется значение false.Примечание.Этот атрибут не обрабатывается для языков, отличных от Visual Basic. Кроме того, для этого параметра устанавливается значение true в файле конфигурации Machine.config. Дополнительные сведения см. в разделе Файлы конфигурации компьютеров.
Inherits
Определяет класс с выделенным кодом для элемента управления. Этот класс может быть любым классом, производным от класса UserControl. Используется с атрибутом CodeFile, содержащим путь к исходному файлу для класса с выделенным кодом. Дополнительные сведения о классах с выделенным кодом см. в разделе Модель кода веб-страниц ASP.NET.Language
Задает язык, используемый при компиляции всех находящихся внутри элемента управления встроенных блоков выполнения (<% %> and <%= %>) и объявлений кода. Значение может быть любым поддерживаемым .NET Framework языком, включая Visual Basic, C# или JScript. Для каждого элемента управления используется и задается только один язык.LinePragmas
Определяет, должна ли среда выполнения создавать строки директивы pragma в исходном коде. Эти параметры компилятора часто используются средствами отладки для отметки определенных расположений в исходном файле. Если строки директивы pragma должны быть созданы, значение —true; в противном случае значение — false.Src
Задает путь к исходному файлу, содержащему связанный с элементом управления код. В связанном исходном файле использовать логику программирования для элемента управления можно как в классе, так и в блоках объявлений кода.Атрибут Src используется для связи поставщиков построения с элементом управления. Дополнительные сведения см. в описании класса BuildProvider. В версиях ASP.NET, предшествовавших версии 2.0, атрибут Src применялся в качестве альтернативы для связи файла кода программной части с элементом управления. В ASP.NET версии 2.0 рекомендуемым способом связи исходного файла фонового кода с элементом управления является использование атрибута Inherits для определения класса, а также атрибута CodeFile для задания пути к исходному файлу для класса.
Strict
Указывает, что для компиляции элемента управления необходим режим Visual Basic OptionStrict. Если режим Option Strict включен, значение — true; в противном случае значение — 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" %>