| Главная » Статьи » Visual Basic » Библиотека Visual Basic |
@ Page
Определяет особые атрибуты для страницы (файла ASPX), используемые анализатором и компилятором страниц ASP.NET.
Атрибуты Async Преобразует страницу в асинхронный обработчик (то есть определяет на странице использование реализации IHttpAsyncHandler для обработки запросов). Значение по умолчанию: false. AsyncTimeOut Определяет интервал времени ожидания (в секундах) при обработке асинхронных задач.Значение по умолчанию — 45 секунд. Значением должно быть целое число. Дополнительные сведения см. в описании свойства AsyncTimeout. AspCompat Если выбрано значение true, то страница может выполняться в режиме однопотокового подразделения (STA). Это позволяет странице вызывать компоненты в однопотоковых подразделениях, например компонент, разработанный с помощью Microsoft Visual Basic 6.0.Если свойству задано значение true, страница также может вызывать компоненты COM+ 1.0, которым требуется доступ к неуправляемым встроенным объектам ASP. Это можно осуществить с помощью объекта ObjectContext или метода OnStartPage. Значение по умолчанию: false.
AutoEventWireup Указывает, будут ли события страницы автоматически связываться друг с другом.true, если включена автоматическая запись события; в противном случае false. Значение по умолчанию равно true. Buffer Определяет, включена ли буферизация ответных сообщений HTTP.true, если буферизация страницы разрешена; в противном случае — false. Значение по умолчанию равно true. ClassName Строка, указывающая имя класса страницы, который будет динамически компилироваться при запросе этой страницы.Этим значением может быть любое действительное имя класса, включая полное имя класса.Если для данного атрибута значение не указано, имя класса для скомпилированной страницы создается на основе имени файла этой страницы при использовании пространства имен ASP. Если в значении атрибута ClassName не указано полное пространство имен, то для создания полного имени класса используется пространство имен ASP и указанное имя класса. Другая страница может ссылаться на имя класса, назначенное первой странице с помощью директивы @ Reference.
ClientIDMode Задает алгоритм, используемый для формирования значений ClientID для элементов управления. Значение по умолчанию — AutoID. По умолчанию для элементов управления установлено значение Inherit. Соответственно, алгоритм по умолчанию для элементов управления на странице определяется параметром страницы ClientID. Другое значение по умолчанию можно задать в элементе pages файла Web.config. ClientTarget Указывает конечный агент пользователя (обычно веб-обозреватель, например, Microsoft Internet Explorer), для которого в серверных элементах управления ASP.NET будет отображаться содержимое.В качестве значения может использоваться любой допустимый псевдоним, определенный в разделе <clientTarget> файла конфигурации приложения. CodeBehind Задает имя скомпилированного файла, содержащего связанный со страницей класс.Этот атрибут не используется во время выполнения.
CodeFile Задает путь к файлу с выделенным кодом страницы.Этот атрибут используется вместе с атрибутом Inherits для связи исходного файла с выделенным кодом с веб-страницей. Атрибут допустим только для скомпилированных страниц. CodeFileBaseClass Задает имя типа базового класса для страницы и связанного с ним класса с выделенным кодом.Этот атрибут является необязательным, однако если он используется, то также должен присутствовать атрибут CodeFile. Данный атрибут используется при реализации общего сценария, в котором в базовом классе определяются общие поля (а также связанные события) для ссылки на элементы управления, объявленные на веб-странице.В связи с особенностями модели создания кода ASP.NET при определении полей в базовом классе без использования данного атрибута во время компиляции будут созданы новые определения членов для элементов управления, объявленных на веб-странице (в заглушке отдельного разделяемого класса), и требуемый сценарий не будет работать.Однако если атрибут CodeFileBaseClass используется для связи базового класса со страницей, а разделяемый класс (его имя назначается атрибуту Inherits и на его исходный файл ссылается атрибут CodeFile) наследуется от базового класса, то после создания кода в полях базового класса могут находиться ссылки на элементы управления на странице. CodePage Указывает значение схемы кодирования, используемой для ответов.Значение представляет собой целое число, которое используется в качестве идентификатора схемы кодирования. CompilationMode Указывает, должна ли для компиляции страницы использоваться строка, в которой определяется один из нескольких перечисленных параметров.По умолчанию используется значение Always, поэтому по умолчанию выполняется компиляция страниц ASPX. CompilerOptions Строка с параметрами компилятора, используемыми для компиляции страницы.Для языков C# и Visual Basic эта строка представляет собой последовательность переключателей командной строки компилятора. ContentType Определяет тип HTTP-содержимого ответа как стандартный тип MIME.Поддерживается любая строка, содержащая допустимый тип HTTP-содержимого. Culture Определяет язык и региональные параметры страницы.Значением этого атрибута должен быть допустимый идентификатор языка и региональных параметров.Обратите внимание, что атрибуты LCID и Culture являются взаимоисключающими. При использовании одного из них использовать второй атрибут на той же странице нельзя Debug Указывает, должна ли страница компилироваться с помощью символов отладки.Если для компиляции страницы должны использоваться символы отладки, следует задать значение true; в противном случае — значение false. Поскольку данный параметр влияет на производительность, во время разработки данный атрибут должен иметь значение true. Description Предоставляет текстовое описание страницы.Это значение не обрабатывается анализатором ASP.NET. EnableEventValidation Включает проверку событий в сценариях обратной передачи и обратного вызова.Значение true, если события проверяются; в противном случае — значение false. Значение по умолчанию равно true. Проверка событий страницы снижает вероятность неавторизованных обратных запросов и обратных вызовов.Если свойство enableEventValidation имеет значение true, то ASP.NET разрешает только события, которые могут вызываться элементом управления при обратном запросе или обратном вызове. В этой модели события элемента управления регистрируются при его отрисовке, а затем проверяются при обработке обратной передачи или обратных вызовов.По умолчанию эта функция действует для всех элементов управления на основе событий в ASP.NET. Настоятельно рекомендуется не отключать проверку событий.Перед отключением проверки событий следует убедиться, что нельзя создать ни одной обратной передачи, которая могла бы оказать нежелательное воздействие на работу приложения. EnableSessionState Определяет требования к состоянию сеанса для страницы.true, если состояние сеанса включено; ReadOnly, если состояние сеанса можно читать, но не изменять; в противном случае false. Значение по умолчанию равно true. В этих значениях не учитывается регистр символов. EnableTheming Указывает, используются ли темы на странице.true, если темы используются, в противном случае – false. Значение по умолчанию равно true. EnableViewState Указывает, сохраняется ли состояние отображения в запросах к страницам.Это значение равно true , если состояние просмотра сохраняется, или false, если состояние просмотра не сохраняется. Значение по умолчанию равно true. Даже если это свойство имеет значение true, состояние представления не будет поддерживаться для элемента управления, если выполняется одно из следующих условий: Свойство EnableViewState элемента управления имеет значение false. Свойству ViewStateMode элемента управления присваивается значение Disabled, или элемент управления наследует значение Disabled. EnableViewStateMac Указывает, что ASP.NET должен проверять коды проверки подлинности сообщений (MAC) в состоянии просмотра страницы, когда выполняется обратная отправка страницы от клиента.true, если состояние просмотра должно быть проверено MAC; в противном случае false. Значение по умолчанию равно true.
ErrorPage Определяет конечный URL-адрес, используемый для перенаправления в случае возникновения на странице необработанных исключений. Explicit Определяет, компилируется ли страница с помощью режима Option Explicit Visual Basic. true указывает, что включен явный параметр компиляции Visual Basic, и что все переменные должны быть объявлены с помощью оператора Dim, Private, Public или ReDim; в противном случае false. Значение по умолчанию: false.
Inherits Определяет наследуемый страницей класс с выделенным кодом.Это может быть любой класс, производный от класса Page. Данный атрибут используется с атрибутом CodeFile, содержащим путь к исходному файлу класса с выделенным кодом. В атрибуте Inherits регистр учитывается при использовании на странице языка C#, и не учитывается при использовании языка Visual Basic. Если атрибут Inherits не содержит пространство имен, ASP.NET проверяет, содержится ли пространство имен в атрибуте ClassName. Если содержится, то ASP.NET пытается загрузить класс, на который ссылается атрибут Inherits, с помощью пространства имен атрибута ClassName. (Предполагается, что атрибуты Inherits и ClassName используют одинаковые пространства имен. Language Задает язык, используемый при компиляции всех находящихся внутри страницы встроенных блоков выполнения (<% %> и <%= %>) и объявлений кода.Значение может быть любым поддерживаемым языком платформы .NET Framework, включая Visual Basic, C# или JScript.Для каждой страницы может задаваться и использоваться только один язык. LCID Определяет код языка для страницы Web Forms.
LinePragmas Определяет, должна ли среда выполнения создавать прагмы в исходном коде.Эти параметры компилятора часто используются средствами отладки для отметки определенных мест в исходном файле.true, если следует создавать строковые прагмы; в противном случае false. MaintainScrollPositionOnPostback Указывает, возвращается ли пользователь на прежнюю позицию в браузере после обратной передачи.true, если пользователи должны быть возвращены в то же положение; в противном случае false. Значение по умолчанию: false.
MasterPageFile Задает путь к главной странице для страницы содержимого или вложенной главной страницы.Поддерживаются как относительные, так и абсолютные пути. MetaDescription Задает свойство MetaDescription. Если в разметке страницы также имеется элемент meta "описания", то значение в директиве @ Page переопределяет значение в разметке. MetaKeywords Задает свойство MetaKeywords. Если в разметке страницы также имеется элемент meta "ключевых слов", то значение в директиве @ Page переопределяет значение в разметке. ResponseEncoding Указывает имя схемы кодирования, используемой для HTTP-ответа, содержащего содержимое страницы.Значение, присвоенное этому атрибуту, является допустимым именем кодировки.список допустимых имен кодировок см. в описании класса Encoding. Список возможных имен кодировок и их идентификаторов можно вызвать с помощью метода GetEncodings. SmartNavigation Указывает, поддерживает ли страница функциональную возможность улучшенных переходов Internet Explorer 5.5 или более поздней версии.true, если включен режим улучшенных переходов; в противном случае — false. Значение по умолчанию: false. В ASP.NET версии 2.0 и последующих версиях свойство SmartNavigation является устаревшим. Вместо этого воспользуйтесь методам SetFocus и свойством MaintainScrollPositionOnPostback . Src Задает путь к исходному файлу, содержащему связанный со страницей код.В связанном исходном файле использовать программный код для страницы можно как в классе, так и в блоках объявлений кода. Атрибут Src используется для связи поставщиков построений со страницей. Дополнительные сведения см. в разделах BuildProvider. В версиях ASP.NET, предшествовавших версии 2.0, атрибут Src применялся в качестве альтернативного способа связи файла с выделенным кодом со страницей. В ASP.NET версии 2.0 рекомендуемым способом связи исходного файла с выделенным кодом со страницей является использование атрибута Inherits для указания класса вместе с атрибутом CodeFile для задания пути к исходному файлу для класса. Strict Указывает, что страница должна компилироваться с помощью режима OptionStrict Visual Basic. true, если Option Strict включен, в противном случае — false. Значение по умолчанию: false.
StyleSheetTheme Указывает допустимый идентификатор темы для использования на странице.Если атрибут StyleSheetTheme установлен, отдельные элементы управления могут переопределять параметры стиля, содержащиеся в теме. Таким образом, тема может задавать общий вид страницы, в то время как параметры, содержащиеся в атрибуте StyleSheetTheme, позволяют настроить конкретные параметры страницы и элементы управления для них TargetSchema Задает имя схемы, которая служит для проверки содержимого на странице.Она используется только в описательных целях. В действительности проверка не производится и анализатор не обрабатывает атрибут. Theme Указывает допустимый идентификатор темы для использования на странице.Если атрибут Theme задается без указания атрибута StyleSheetTheme, то он переопределяет отдельные параметры стиля элементов управления, позволяя создать единый вид страницы. Title Указывает заголовок страницы, который отображается внутри HTML-тегов <title> в ответе. С заголовком можно работать программными средствами как к свойству страницы. Trace Указывает, включена ли трассировка.Значение true, если трассировка включена; в противном случае — значение false. Значение по умолчанию: false. TraceMode При включенной трассировке указывает способ отображения сообщений для страницы.Возможными значениями являются SortByTime и SortByCategory. Когда трассировка включена, значением по умолчанию является SortByTime. Transaction Указывает, поддерживаются ли транзакции COM+ для данной страницы.Допустимые значения: Disabled, NotSupported, Supported, Required и RequiresNew. Значение по умолчанию: Disabled. UICulture Задает используемые для данной страницы языковые и региональные параметры интерфейса пользователя.Поддерживаются любые разрешенные значения языковых и региональных параметров интерфейса пользователя. ValidateRequest Указывает, должна ли выполняться проверка запросов.При значении true все входные данные проверяются на соответствие с жестко заданным списком потенциально опасных значений. Если найдено соответствие, вызывается исключение HttpRequestValidationException. Значение по умолчанию равно true. Эта функция включается в файле конфигурации компьютера (Machine.config).Ее можно отключить в файле конфигурации приложения (Web.config) или на странице, установив значение false для данного атрибута.
ViewStateEncryptionMode Определяет способ шифрования состояния просмотра с помощью трех значений: Auto, Always или Never. По умолчанию используется значение Auto, означающее, что шифрование состояния просмотра будет выполняться по запросу отдельных элементов управления. ViewStateMode Задает значение свойства ViewStateMode , которое вступит в силу для элемента управления, если свойство ViewStateMode элемента управления равно Inherit. Значение ViewStateMode по умолчанию для страницы равно Enabled. Свойства ViewStateMode и EnableViewState определяют, сохраняется ли состояние представления для элементов управления на странице. WarningLevel Указывает уровень предупреждений компилятора, при котором он будет рассматривать предупреждения как ошибки, прерывая, таким образом, компиляцию страницы.Возможны уровни предупреждений от 0 до 4. Заметки Эта директива может использоваться только на страницах Web Forms.В файле ASPX может содержаться только одна директива @ Page. Также для директивы @ Page можно определять только один атрибут Language, поскольку на одной странице может использоваться только один язык. Поскольку для большинства атрибутов предоставляются наиболее часто используемые значения по умолчанию (либо в исходном коде, либо в файлах конфигурации), часто добавлять большой набор атрибутов в директиву оказывается необязательно.Как правило, чтобы задать необходимые функции для страницы, необходимо добавить минимальный набор атрибутов.Если какой-либо атрибут необходимо применить для всех страниц, например, включить трассировку на всех страницах, проще это сделать, включив соответствующую возможность в файле Web.config, чем добавлять атрибут Trace для каждой страницы.
Чтобы определить несколько атрибутов для директивы @ Page, каждую пару "атрибут-значение" следует отделить одиночным пробелом. При определении конкретного атрибута не следует использовать пробел с какой-либо стороны знака равенства (=), связывающего атрибут с его значением. Режим улучшенных переходов — это функция ASP.NET, используемая в обозревателе Internet Explorer 5.5 и более поздних версиях.Данный режим позволяет выполнять обновление страницы с сохранением положения прокрутки и фокуса элемента при переходах. В результате в журнале обозревателя сохраняется только одна страница и отсутствует "мерцание", связанное с обновлением веб-страницы.Режим улучшенных переходов лучше всего подходит для страниц ASP.NET, которые подразумевают частые обратные передачи, но содержат незначительно изменяющееся при возврате визуальное содержимое.Следует внимательно рассмотреть эти соображения при установке значения true данного атрибута. Если атрибут AspCompat для страницы имеет значение true, то при использовании конструктора для создания COM-компонента перед планированием запроса, он будет выполняться в потоке многопотокового подразделения (MTA). Это вызывает сильное снижение производительности веб-сервера.Чтобы избежать этого, необходимо создавать COM-компоненты только в одном из событий Page (например, Page_Load, Page_Init и др.) или в одном из методов Page. Кроме того, объекты не должны создаваться в момент построения страницы. В следующем примере показывается рекомендуемый способ создания экземпляра COM-компонента на странице с включенным атрибутом AspCompat. VB
VB
Пример В следующем примере кода указывается, что компилятор страниц ASP.NET должен использовать Visual Basic в качестве языка кода страницы на стороне сервера, а для атрибута HTTP MIME ContentType, передаваемого клиенту, устанавливается значение "text/xml".
Источник: http://expert1.ucoz.com/ | |||||||||||||||||||||||||||
| Просмотров: 2427 | Теги: | Рейтинг: 0.0/0 | |||||||||||||||||||||||||||
| Всего комментариев: 0 | |