Sdílet prostřednictvím

HyperLink.Target Vlastnost

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Získá nebo nastaví cílové okno nebo rámeček, ve kterém se má zobrazit obsah webové stránky propojený při kliknutí na HyperLink ovládací prvek.

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

Hodnota vlastnosti

String

Cílové okno nebo rámec pro načtení webové stránky propojené s po kliknutí na HyperLink ovládací prvek. Hodnoty musí začínat písmenem v oblasti až z (nerozlišují malá a velká písmena), s výjimkou speciálních hodnot uvedených v následující tabulce, které začínají podtržítkem.

_blank Vykreslí obsah v novém okně bez rámců.
_parent Vykreslí obsah v nadřazené sadě snímků.
_search Vykreslí obsah v podokně hledání.
_self Vykreslí obsah v rámci s fokusem.
_top Vykreslí obsah v úplném okně bez rámců.

Poznámka: Zkontrolujte dokumentaci k prohlížeči a zjistěte, jestli _search je hodnota podporovaná. Například Aplikace Microsoft Internet Explorer 5.0 a novější podporuje _search cílovou hodnotu.

Výchozí hodnota je prázdný řetězec ("").

Atributy
BindableAttribute TypeConverterAttribute

Příklady

Následující příklad ukazuje, jak nastavit Target vlastnost určit okno nebo rámec pro zobrazení stránky přidružené k HyperLink ovládacího prvku.

<%@ 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>

Poznámky

Target Pomocí vlastnosti můžete určit rámec nebo okno, na které se zobrazí webová stránka propojená při kliknutí na HyperLink ovládací prvek. Webová stránka je určena nastavením NavigateUrl vlastnosti.

Pokud tato vlastnost není nastavená, prohlížeč nebo okno s fokusem HyperLink se při kliknutí na ovládací prvek aktualizuje.

Poznámka:

Vlastnost Target se vykreslí jako target atribut. Atribut target elementů anchor není povolen v definici typu dokumentu XHTML 1.1. Nenastavujte Target vlastnost, pokud vykreslený výstup musí HyperLink být XHTML 1.1 kompatibilní. Další informace najdete v tématu XHTML Standardy v sadě Visual Studio a ASP.NET.

Při vytváření přístupných webových stránek důrazně doporučujeme vyhnout se použití Target vlastnosti pro cílení na jiné okno. Další informace najdete v tématu Přístupnost v sadě Visual Studio a ASP.NET a ASP.NET ovládací prvky a přístupnost.

Platí pro

Viz také