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

@ Page
Определяет особые атрибуты для страницы (файла ASPX), используемые анализатором и компилятором страниц ASP.NET.

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

Атрибуты

Async

Преобразует страницу в асинхронный обработчик (то есть определяет на странице использование реализации IHttpAsyncHandler для обработки запросов).

Значение по умолчанию: false.

AsyncTimeOut

Определяет интервал времени ожидания (в секундах) при обработке асинхронных задач.Значение по умолчанию — 45 секунд.

Значением должно быть целое число.

Дополнительные сведения см. в описании свойства AsyncTimeout.

AspCompat

Если выбрано значение true, то страница может выполняться в режиме однопотокового подразделения (STA). Это позволяет странице вызывать компоненты в однопотоковых подразделениях, например компонент, разработанный с помощью Microsoft Visual Basic 6.0.Если свойству задано значение true, страница также может вызывать компоненты COM+ 1.0, которым требуется доступ к неуправляемым встроенным объектам ASP. Это можно осуществить с помощью объекта ObjectContext или метода OnStartPage. Значение по умолчанию: false.

Примечание
Значение true данного атрибута может вызвать снижение производительности работы со страницей. Дополнительные сведения см. в разделе "Примечания".

AutoEventWireup

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

Buffer

Определяет, включена ли буферизация ответных сообщений HTTP.true, если буферизация страницы разрешена; в противном случае — false.

Значение по умолчанию равно true.

ClassName

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

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

Примечание
В классе с выделенным кодом страницы можно ссылаться на члены класса связанной страницы ASPX при помощи полного имени класса для страницы ASPX.Однако при включении защиты исходного кода во время предварительной компиляции класс с выделенным кодом страницы будет находиться в сборке, отличной от той, в которой находится класс страницы ASPX.Поэтому ссылка на класс в файле с выделенным кодом не будет работать.

ClientIDMode

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

ClientTarget

Указывает конечный агент пользователя (обычно веб-обозреватель, например, Microsoft Internet Explorer), для которого в серверных элементах управления ASP.NET будет отображаться содержимое.В качестве значения может использоваться любой допустимый псевдоним, определенный в разделе <clientTarget> файла конфигурации приложения.

CodeBehind

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

Примечание
Этот атрибут включен для обеспечения совместимости с предыдущими версиями ASP.NET и используется для реализации функции с выделенным кодом.Чтобы задать имя исходного файла в ASP.NET версии 2.0 и более поздних версий, следует использовать атрибут CodeFile, а чтобы задать полное имя класса — атрибут Inherits.

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.

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

ErrorPage

Определяет конечный URL-адрес, используемый для перенаправления в случае возникновения на странице необработанных исключений.

Explicit

Определяет, компилируется ли страница с помощью режима Option Explicit Visual Basic. true указывает, что включен явный параметр компиляции Visual Basic, и что все переменные должны быть объявлены с помощью оператора Dim, Private, Public или ReDim; в противном случае false. Значение по умолчанию: false.

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

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.

Примечание
Код языка представляет собой 32-разрядное значение, однозначно определяющее языковой стандарт.Если в данном атрибуте не указано иное значение для страницы Web Forms, то в ASP.NET будет использоваться языковой стандарт веб-сервера по умолчанию.Обратите внимание, что атрибуты LCID и Culture являются взаимоисключающими. При использовании одного из них использовать второй атрибут на той же странице нельзя.

LinePragmas

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

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

Примечание
Разработчики могут задать этот атрибут для всех страниц, установив атрибут maintainScrollPostitionOnPostback (обратите внимание, что в файлах конфигурации для этого атрибута учитывается регистр) для элемента <pages> в файле Web.config.

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.

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

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 для данного атрибута.

Примечание
Данная функция позволяет уменьшить риск межузловых скриптовых атак для страниц, запрашиваемых напрямую, и приложений ASP.NET.Приложение, не проверяющее вводимые пользователем данные должным образом, уязвимо для различных типов атак, связанных с вводом неправильных данных, включая межузловые скриптовые атаки и атаки путем внедрения кода SQL.Здесь возможно только аккуратно анализировать все входные данные в приложении и гарантировать их должную проверку и кодирование, либо обеспечивать выход из приложения перед обработкой данных или их отправкой клиенту.

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 имеет ряд атрибутов, общих с другими директивами, которые применяются ко всему исходному файлу, таких как директива @ Control (используется в файлах ASCX для пользовательских элементов управления) и директива @ Master (используется в файлах MASTER для главных страниц).

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

Режим улучшенных переходов — это функция ASP.NET, используемая в обозревателе Internet Explorer 5.5 и более поздних версиях.Данный режим позволяет выполнять обновление страницы с сохранением положения прокрутки и фокуса элемента при переходах. В результате в журнале обозревателя сохраняется только одна страница и отсутствует "мерцание", связанное с обновлением веб-страницы.Режим улучшенных переходов лучше всего подходит для страниц ASP.NET, которые подразумевают частые обратные передачи, но содержат незначительно изменяющееся при возврате визуальное содержимое.Следует внимательно рассмотреть эти соображения при установке значения true данного атрибута.

Если атрибут AspCompat для страницы имеет значение true, то при использовании конструктора для создания COM-компонента перед планированием запроса, он будет выполняться в потоке многопотокового подразделения (MTA). Это вызывает сильное снижение производительности веб-сервера.Чтобы избежать этого, необходимо создавать COM-компоненты только в одном из событий Page (например, Page_Load, Page_Init и др.) или в одном из методов Page. Кроме того, объекты не должны создаваться в момент построения страницы.

В следующем примере показывается рекомендуемый способ создания экземпляра COM-компонента на странице с включенным атрибутом AspCompat.

VB

<%@ Page AspCompat="true" language="VB" %>
<script runat="server" >

    Dim comObj As MyComObject

    Public Sub Page_Load()
     'Use comObj here when the code is running on the STA thread pool.comObj = New MyComObject()
     ' Do something with the combObj object.End Sub
</script>


VB

<%@ Page AspCompat="true" language="VB" %>
<script runat="server" >
</script>


Примечание
Добавление директивы @ Master на главную страницу не допускает использование того же объявления директивы на страницах, зависящих от главной. Вместо этого для глобального определения директив страниц следует использовать элемент pages.

Пример

В следующем примере кода указывается, что компилятор страниц ASP.NET должен использовать Visual Basic в качестве языка кода страницы на стороне сервера, а для атрибута HTTP MIME ContentType, передаваемого клиенту, устанавливается значение "text/xml".

<%@ Page Language="VB" ContentType="text/xml" %>



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