Поделиться через

Декларативный синтаксис серверного веб-элемента управления HyperLink

  • Статья

Обновлен: Ноябрь 2007

Создает ссылку на страницу, которую можно выбрать для перехода на другую страницу.

<asp:HyperLink
    AccessKey="string"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    CssClass="string"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
        Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    Height="size"
    ID="string"
    ImageUrl="uri"
    href="uri"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    runat="server"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    Target="string|_blank|_parent|_search|_self|_top"
    Text="string"
    ToolTip="string"
    Visible="True|False"
    Width="size"
/>

Заметки

Элемент управления HyperLink предназначен для создания ссылки на другую страницу или на другое расположение на странице. Ссылочная страница или расположение задается с помощью свойства href. Ссылка может отображаться либо в виде текста, либо в виде изображения. В первом случае необходимо установить свойство Text или поместить текст между открывающим и закрывающим тегами элемента управления HyperLink. Для отображения изображения нужно установить свойство ImageUrl.

k0b15efk.alert_note(ru-ru,VS.90).gifПримечание.

Поскольку элемент <asp:HyperLink> не имеет содержимого, можно закрыть тег с помощью /> вместо использования отдельного закрывающего тега.

Если заданы оба свойства (Text и ImageUrl), свойство ImageUrl имеет больший приоритет. Если изображение недоступно, вместо него в свойстве Text будет выведен текст. В обозревателях, поддерживающих отображение всплывающих подсказок, значение свойства Text отображается при наведении указателя мыши на элемент управления HyperLink.

В свойстве Target задается фрейм или окно для отображения связанной страницы. Значения должны начинаться с буквы от "a" до "z" (регистр не учитывается), за исключением случаев, когда используются следующие специальные значения, начинающиеся со знака подчеркивания.

_blank

Связанная страница открывается в новом окне без фреймов.

_parent

Связанная страница открывается в текущем родительском наборе рамок.

_self

Связанная страница открывается в активном фрейме.

_top

Связанная страница открывается в полноэкранном режиме без фреймов.
k0b15efk.alert_caution(ru-ru,VS.90).gifВнимание!

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

Подробные сведения о свойствах и событиях серверного веб-элемента управления HyperLink см. в документации HyperLink.

При использовании серверного веб-элемента управления HyperLink для переходов между страницами приложения можно воспользоваться подстановочным знаком "тильда" (~), чтобы обозначить корневой каталог приложения без жесткого задания имени каталога в относительном URL-адресе приложения. Например, чтобы вернуться на страницу Default.aspx с любой страницы подкаталога приложения, можно использовать "~/Default.aspx".

Пример

В следующем примере показано, как использовать элемент управления HyperLink для перехода на другую веб-страницу.

<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>HyperLink Example</title>
</head>
<body>
<form id="Form1" runat="server">


   <h3>HyperLink Example</h3>

   Click on the HyperLink:<br />  

   <asp:HyperLink id="hyperlink1" 
                  ImageUrl="images/pict.jpg"
                  href="https://www.microsoft.com"
                  Text="Microsoft Official Site"
                  Target="_new"
                  runat="server"/>       
</form>
</body>
</html>


<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>HyperLink Example</title>
</head>
<body>
<form id="Form1" runat="server">

   <h3>HyperLink Example</h3>

   Click on the HyperLink:<br />  

   <asp:HyperLink id="hyperlink1" 
                  ImageUrl="images/pict.jpg"
                  href="https://www.microsoft.com"
                  Text="Microsoft Official Site"
                  Target="_new"
                  runat="server"/>       
</form>
</body>
</html>


<%@ Page Language="JScript" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>HyperLink Example</title>
</head>
<body>
<form id="Form1" runat="server">

  <h3>HyperLink Example</h3>

   Click on the HyperLink:<br />  

   <asp:HyperLink id="hyperlink1" 
                  ImageUrl="images/pict.jpg"
                  href="https://www.microsoft.com"
                  Text="Microsoft Official Site"
                  Target="_new"
                  runat="server"/>       
</form>
</body>
</html>

См. также

Ссылки

HyperLink

Другие ресурсы

Синтаксис серверного веб-элемента управления