HyperLink.Target Свойство

  • Ссылка

Определение

Пространство имен:
System.Web.UI.WebControls
Сборка:
System.Web.dll

Возвращает или задает целевое окно или фрейм, в которых отображается содержимое веб-страницы для перехода при выборе элемента управления 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

Значение свойства

String

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

_blank Отображает содержимое в новом окне без фреймов.
_parent Отрисовывает содержимое в непосредственно родительском элементе набора фреймов.
_search Отображает содержимое в панели поиска.
_self Отображает содержимое во фрейме с фокусировкой.
_top Отображает содержимое в окне без фреймов.

Примечание. Проверьте документацию браузера, чтобы определить, поддерживается ли _search значение. Например, Microsoft Internet Explorer 5.0 или более поздней версии поддерживает целевое значение _search.

Значение по умолчанию — пустая строка.

Атрибуты
BindableAttribute TypeConverterAttribute

Примеры

В следующем примере показано, как задать 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 и специальных возможностях.

Применяется к

См. также раздел