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 и специальных возможностях.