HyperLink.Target Vlastnost

  • Reference

Definice

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

Získá nebo nastaví cílové okno nebo rámec, ve kterém chcete zobrazit obsah webové stránky odkazované na 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, na který se má načíst webová stránka propojená při kliknutí na HyperLink ovládací prvek. Hodnoty musí začínat písmenem v rozsahu od a do z (nerozlišují se 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 bezprostředně nadřazené sadě rámců.
_search Vykreslí obsah v podokně hledání.
_self Vykreslí obsah v rámci s fokusem.
_top Vykreslí obsah v celém okně bez snímků.

Poznámka: V dokumentaci k prohlížeči zjistěte, jestli _search je tato hodnota podporovaná. Například Microsoft Internet Explorer 5.0 a novější podporují _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 ovládacímu HyperLink 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 určete rámec nebo okno, které zobrazí webovou stránku propojenou 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 se po kliknutí na HyperLink ovládací prvek aktualizuje.

Poznámka

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

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

Platí pro

Viz také