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 щелчком элемента управления. Значения должны начинаться с буквы в диапазоне от 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 и специальные возможности.