HyperLink.Target Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает целевое окно или фрейм, в которых отображается содержимое веб-страницы для перехода при выборе элемента управления HyperLink.
public:
property System::String ^ Target { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Bindable(true)]
[System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))]
public string Target { get; set; }
[System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))]
public string Target { get; set; }
[<System.ComponentModel.Bindable(true)>]
[<System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))>]
member this.Target : string with get, set
[<System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))>]
member this.Target : string with get, set
Public Property Target As String
Значение свойства
Целевое окно или фрейм для загрузки веб-страницы, на которую осуществляется переход при выборе элемента управления HyperLink. Значения должны начинаться с буквы в диапазоне от a до z (без учета регистра), за исключением особых значений, начинающихся с подчеркивания, которые перечислены в следующей таблице.
_blank | Отображает содержимое в новом окне без фреймов. |
_parent | Отрисовывает содержимое в непосредственно родительском элементе набора фреймов. |
_search | Отображает содержимое в панели поиска. |
_self | Отображает содержимое во фрейме с фокусировкой. |
_top | Отображает содержимое в окне без фреймов. |
Примечание. Проверьте документацию браузера, чтобы определить, поддерживается ли _search
значение. Например, Microsoft Internet Explorer 5.0 или более поздней версии поддерживает целевое значение _search
.
Значение по умолчанию — пустая строка.
- Атрибуты
Примеры
В следующем примере показано, как задать Target свойство , чтобы указать окно или фрейм для отображения страницы, связанной с элементом HyperLink управления .
<%@ 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 Sample</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>HyperLink Sample</h3>
Click on the HyperLink:<br />
<asp:HyperLink id="hyperlink1"
ImageUrl="images/pict.jpg"
NavigateUrl="http://www.microsoft.com"
Text="Microsoft Official Site"
Target="_blank"
runat="server"/>
</form>
</body>
</html>
<%@ 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 Sample</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>HyperLink Sample</h3>
Click on the HyperLink:<br />
<asp:HyperLink id="hyperlink1"
ImageUrl="images/pict.jpg"
NavigateUrl="http://www.microsoft.com"
Text="Microsoft Official Site"
Target="_blank"
runat="server"/>
</form>
</body>
</html>
Комментарии
Используйте свойство , Target чтобы указать фрейм или окно, в котором отображается веб-страница, с которым связана при щелчке HyperLink элемента управления. Веб-страница задается путем NavigateUrl установки свойства .
Если это свойство не задано, браузер или окно с фокусом обновляется при щелчке HyperLink элемента управления.
Примечание
Свойство Target отрисовывается в виде атрибута target
. Атрибут target
элементов anchor
не допускается в определении типа документа XHTML 1.1. Не устанавливайте свойство , Target если отображаемые выходные HyperLink данные для должны соответствовать XHTML 1.1. Дополнительные сведения см. в статье Стандарты XHTML в Visual Studio и ASP.NET.
При создании веб-страниц со специальными возможностями настоятельно рекомендуется избегать использования свойства для другого Target окна. Дополнительные сведения см. в разделах Специальные возможности в Visual Studio и ASP.NET и ASP.NET Controls and Accessibility.